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Timbuktu Pro 

Whether you're at home or at work, Timbuktu Pro allows you to operate distant 
computers as if you were sitting in front of them, transfer files or folders quickly 
and easily, and communicate by instant message, text chat, or voice intercom. 
http://www.timbuktupro.com 


netOctopus 

Intuitive and powerful, netOctopus can manage a network of ten or 10,000 
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C-TREE* SERVER SDK 



Today's database deniatids are often too complex for traditional database servers. 
The funclionality and precise level of control you need is simply not available. 
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threading or communication logic. 

Faii<!t>ni's c-tree® Server SDK allows you to create a custQmi/.ed, 
industrial-strength server designed for your particular needs. Use 
FairConTs kernel, with over 20 years of proven stability, or override 
functionality within specific subsystems to implement your own 
subtleties. Move your application's data I/O functions to the 
server-side to decrease network trainc and increase 
performance! 

FairCom’s entree Server SDK is used by companies 
worldwide such as Software AG and Citibank’*, It’s 
integrated seamlessly into c-tree Plus and includes 
cumplcle source code to the server mainline and all the 
interface subsystems to the c-trec Server. And 
best of all, once you’ve created your unique, 
customized server, it is easy to install and 
administer: no DBA required! 
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Move functionality from the client-side to 
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Modify or replace entire server 
subsystems 
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Flexible OEM licensing 
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SYBASE INTEGRATION TECHNOLOGIES- EVERYTHING WOR 


Enterprise 12,5 
MAC OS X : 


HELPING FILEMAKER PRO CUSTm 
SCALE TO NEW HEIGHTS 


Want to enhance the performance 
of FileMaker Pro on MAC OS X? 
The same database engine that 
runs Wall Street can help you do 
just that 


Sybase is helping today's 
leading companies achieve 
Information Liquidity: a highly 
profitable state where ail of 
your information is transformed 
into real economic value. 


ASE 12.5 mcreasesthe reiiabifity, 
availability and scalability of 
your FileMaker Pro application. 
It provides better data integrity, 
world-class security and the 
ability to handle thousands of 
transactions per minute* It'll 
also give your users the power 
of SQL queries. 


A FREE Developer^s Edition 
download is available online 
at sybase.com/filemaker* 


ASE 12.5 for MAC OS X is yet 
one more example of how 
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GETTING 

STARTED 


Copyright 2003 by Dave Mark 


Getting Started: 
More on Xcode 


Let’s take the debugger for a spin. As weVe done lor die 
past few months, we’ll work witli the Sketch sample project. As 
a reminder, the Sketch files live in 
/Deteloper/Excimplt^AppKil/Skelch/. kiuncli Xcode and open the 
pmject Sketch .phxproj. 

SeITING a BR£j^*OlN'lWt)RKlN(i WrJ'H THIi DElitlCitiHR 
When the project window appears, click on the Projecl 
SymfK)ls smart group (left side of the window in the Croups €r 
Files list). When your symbols list appears, click in the search 
field (right side of toolbar) and .search for the string inti. As yf)LJ 
learned last month, this will winnow the list of [>rujecl syiiibcds 
down to those containing the string luiL 

Figure 1 ,shows this list with the init in the file 
SK7'Crapbk jn selected, 'fhis is the file we’re going to edit and 
debug. Dauble-ciick this line so an editing window appears, 
listing die contenis c>f SKTCrapbic.m. 


©aa 
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Figure L Search the Project Symhois forjiks containing inU. 


SeUing a Breakpoint 

Scroll al>t>ut one quarter of the way down the source file and 
click on line 178. As a reminder, the navigation bar is the strip 
immediately above the main editing pane, d’he line niiml:>er 
follows the file name, which is immediately to the light of die 
navigation anows {see Figure 2). Once you kxrate line 178, set 
a breakpoint by clicking in the left column, to the left of die line 
in the editing window. Take a look ai Figure 2. Note that the 
break[X>int arrow a[>[iears to the left of line 178. This means that 
the debugger, (nice started, will stop execiition just before it 
executes die if statement on line 178. 


0© 


& SKTCraphit^fn 




Bitiw Hun ‘ ■ 

Sl(etd^ ^Upgraded) 

r ^^Cra:|thiLfn:].7d 


® P 0 @ 

Kelp Creups Edlttmg Mode 


' ^tapacMjndHyLaniinitiiian 


} 


.^logS.tHniiSutcrtiri^eoi.^ ■ VtS; 
.origBounds « 


- (void>iapBai#ii:jqAiiit|»lattDn { 

if GgFlciflft.JMni|3iylatingfiaijnd«) ( 

// terfitnr* Ute original bounds, thn »ei tN rupir bowds. 
It (4NSEqualRKt3(_arigBDunds , ^bounds)) ( 

MSRect twpj 

^gFli^j.wicnjiatingecMids - Ii3i 


in 




[self satHqundsltaiVjj 

figure 2, Line 178 is selecied. Note the line numlTer in the 
natngalion bar and the hreafipoint set on ibe ie/t. 


To start the debugger, click the Dehiig icon in the 
SK'iCraphic.m editing window’s toolbar. Depending on tilings 
like the speed of your machine, how much of die program is 
already compiled, etc., this may take a bit. Be patient. 

Onee your code is built, die Sketch app is launched Click 
on the rectangle tool and drag out a rectangle. As you release the 
mouse button, the debugger will hit that breakpoint and bring 
the Debug window to the front. Figure 3 shows the Debug 
window when you hit the breakpoint. 


Dave Mark is a longtime Mac developer and MacTcxh contributor. Autlior of more than a dozen books on various Mac^levelopment topics, Dave Ls 
all about Xcode these days. Last month’s column focused on the editor interface as well as fiX“and-continue. This month’s installment will take the 
debugger through a few of its paces, and explore XtxxJe's code completion feature. 
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• (h'^Lcl)«Ci 3 i'tfiHVHliJitanUMlEitlan { 

So**' tii* 

_gFLog«.HinlptiEtitlngDaiiniB # YfS; 

.nrloBnifiA > .bomti; 

} 

- tvDlCi)sUlpB0UiajttenipulOtttfi { 

If <lNSeiiyftllhictfl(joirtgBoMiKli, ,iKii#Tf)i>J ■( 

HSBBCt tJimp; 

l44j.«inttKi|<i(tLn(pautit) - ftd; 

figure 3* WeDehuif window, shoit/in^ the pro^mm /mtsed at a 
breakpoint. Note the display of Locals in the upper-right pane. 

Take a look at the ui^per-right pane in Figure 3. Notice 
the display of variables. You can manipulate the column 
widths by dragging on the splits between the Variable, Value, 
and Summary column headers. I maximized tlie width of llie 
Value column in Figure 3- You can click on the disclosure 
triangles to reveal fields within srructs. Kor example, origin 
has an x and a y component. The origin line lists the values 


of all the origin fields. Open llie triangle and each field gets 
its own line. 

If you double-click on tlie x value, the value of jr turns into 
a Le.xt editing field allowing you to modify the value of x. Just 
as you’d expect. 

But if you doLible-crlick on the origin value (the one that lists 
X and y values separated by a c:omma), the origin formatter will 
appear in a text editing held. In this case, die fomiatting string is^ 

y=%y%%origin%* %siKe% 

Double-click the size value column and tlie size formatter 
will appear: 

w ] <11 b^w i rf t h %. he i ght '=%'h e 1 gh t % 

l.ei’s c^hange the formatrer. Change it to retid: 
w^%width%, h^%h(^ighi:% 

When you finish the edit (liit enter), the change you made- 
will propagate up through lx>th the display of size and any other 
displays that reference size. 'I'o see this for yourself, click the 
Arguments triangle, then the self triangle, then the Jiounds 
inangle to reveal origin and size within Jrounds. On my display 
(see Figure 4), tlie _botmds value field is: 





End the compromise 

with perfect quality and file siz 

. Produce highly compressed, lossless QuickTime videos for delivering screen 
capture training videos, animated text and graphics. r 
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When we changec! one size formatter, the change 
propagated lo all Fields ihal displayed a value of type size. DaUi 
Fonnatters are tied to t)^pe definitions, which are global. 
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Tlie (in my opinion) coolest icon of the buncly the fix 
scotch tape dispenser Is the equivalent of selecting fix from the 
meniL As I mentioned in last month^s column, there 
appears to Itc a glitch with this icon in the Jaguar build of Xccxle 
which I believe is fixed in the Panther build Once Panther is 
officially released, JII definitely be working exclusively with the 
Paniher tools, .st> we’ll get a sense of whaPs wliat in the eiirrent 
release of the tools. 

'Ilie Breakpoints icon brings up the Breaf^oints window 
(see Figure 6), which lisLs all your current breakpoints, 
organized by source file. You can turn breakpoints on and off 
using the checkbox associated witli each breakpoint. 

@ © 0 Breakpoints 
N«w Sr^^kpoint 

▼ SKTGraphie,m 
iJne:17S 


F/gwre 4 In ibis .^hoi, noltce that seif. Jxmnds.size 
uses ibe modified sizeformatler. 

-..1^ > 4 P ^ 


Ff you are Linfajuiliar with fonnatiers, gmb your Favorite C 
text and do a bit of digging. Just like a formatter in a 
printfi K Xcode formatters allow you to specify how the 
debugger displays your variables. There's even an API so 
you can write your own Fonnatters, See the Xcode release 
notes for more info, 


Debug Controls 

Figure 5 shows the debugger controls youH find at rlie top 
of your window. CJiances are, if you’ve ever used a 

debugger before, you’ll recognize most of them. Terminate 
terminates the prcKess l-jeing debugged, Restart terminates the 
pr(K:e,ss and re.sians ii from the beginning. Pause pau.ses and 
Continue coniinues execution from the current sto[3ping point. 
Step executes the next line of code without stepping into 
any fiinc:tions^ while Step Into steps unhe next line of ccxle, even 
if it means stepping into a function. Step Otil completes the 
airrent function and stop.s immediately aftej^ the function's 
return in the calling funciicin. 


© Q 0 Debug - Skeit^i (Sketch lUngt 


# # A! # # 




tffTnrn^e ieitjirt f j , Ceidinuf ^lepthei 

Step IniD Step Out 

fie 

■rejlij»im£ Cufll 

StoppeEl It breiJtpoint. 


Figure % The debugger controls at tbe top 
of the Dehtig window. 


Figure d 7he Brvai^mnts wmdoiiK 

The Console Drawer icon opens a console drawer lx,‘low 
the Debug window, allowing you to directly enter gdh 
commands. This is extremely cool, especially if you come 
from the Unix world and learned debugging using gdb, adb, 
or the e(|uivalent. 

You’ve got the gdlr doc on your hard drive: 

/Developer/Documentation/DeveloperTools/gdlVgdb/gd 

b_toc.html 


Once More Into the Breach 

Let’s take one more spin through the debugger. If Skttcb is 
currently debugging, click tlie Termitmle icon. Now restart 
Sketch by clicking the Debug icon. When Sketch starts nmning, 
do not do anytliing in Sketch, just use the dock to renirn Lo 
Xcode. Hac:k in Xcode, select Mmg-... from the Window menu 
to Ijring the Debug window to il^ie front, Nc3w, click on die Pause 
button tci stop Sketch at whatever iine was executing when you 
clicked the Pause button. 

Figure 7 shows the event trace pane which is a stack 
showing the call sequence with main at the bottom and die 
current function at the top (in this case, the trap 
mach^msgjrap). Basically, this is what your app looks like 
when it is in an idle state, waiting for an event to happen. 
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Sophos Anti-Virus protects your organization at every level, 
every point of entry* Our software intelligently recognizes 
when files neecJ to be virus checked, providing on-access 
scanning and minimizing the impact on system resources. 
Every license includes 24x7x365 unlimited technical support 
as standard and offers comprehensive protection for multiple 
platforms, Including Mac and legacy operating systems. 

In the Sophos Zone, viruses don't worry Mac users at all. 


GET THE FACTS: 

Download a FREE technical brief, 
‘Sophos Anti-Virus for Mac OS X* 
f rom www.sophas.com/Unk/macbrief 
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Hgure Z We mmit trace pane shorn call setifience stack. 


Next, click the Continue icon to get Sketch back up and 
running. B;tck in Sketchy click on the rectangle tool and drag out 
a rectangle. Wlien you let go, you should pop back into tiie 
debugger and your familiar breakpoint. 

Click Step Inlo a few times until this line is highlighted: 


audio recording • editing • effects 


Felt Tip 

Sound Studio 

2.1 
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01002 feR Tip Sofriart. Afl rtjhis rwwwd 


www.felttip.com/ss 


teap = ^bounds: 

Remember, since this line is highlighted it has not yet 
executed Click Step Into one more time. As you can see in 
Figure S, when you execute this line and asvsign a value U> temp, 
the temp fields displayed in the Vrdue column are displayed in 
red, showing that they have changed. 

If you click Step Into one more lime, you'll change hounds. 
7b sw this change, you 'U need to opeti the self iriangie. 
self._h(mnds will turn red and temp will return to black. 
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Figure 8. When tee change the mine in itmp, 
the temp fields turn red. 

Ft>r our Rnal trick, click on the Console Drawer icon. Scroll 
to the bonom of the window till you see this prompt: 

[gdb) 

At the prompt, type die command coutinue and hit return. 
This is exactly as if you had clicked the Continue iom in the 
toolbar. You are now back in Sketch and you can drag out some 
more shapes, as you like. 

Till Next Moiv^ni... 

Whelp, fm out of space again, <sigh>, I'here’s so much 
more 1 warn to talk alKHir. Next month, we're going to take the 
debugger througli its paces and we'll also play an>und with a 
featitre called code completion, one of my very favorite parts of 
XcodeYou know, there are way more things 1 want to write 
about than diere is space in Lite maga/ine. Note to .self - see 
about adding more pages to mag. Ah, well. IVe got a cool 
column idea for next month. Not sure 1 can pull it off. Well See 
see. Look for you then.,.© 
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Multiple formats. Multiple platforms. 
Complex installers. 

MaMin solves the cortpr^sim and imtallatim puzzle. 



Hrying to figure out how to handle multiple 
compression formats and platforms? 

The Slujjll Engine solves Ihe compression puzzle. 


Aladdin’s SlulHl Engine SDK; 

► Adds value lo your application by integrating powerful compression and encryiilion. 

► Is the only tool that supports the Stulllt file format. 

► Provides a single API that supports over 20 compression and 
encoding formats common on Macintosh, Windows, and Unix. 

► Makes self-extracting archives for either Macintosh or Windows. 

► Available for Macintosh, Windows, Linux, or Solaris. 


Licenses sun as low 
as (Wyear 

To leam more, wsit: 
www.stu fliLcoiii/sd k/ 


Stuffit Engine SDK" 

The power of Stuffit in your software. 



Looking for the easiest and fastest 
way to build an installer? 

Stuffit InstallerMaker completes your puzzle. 


It s not enough just to write solid code anymore. You still have to write an installer 

for your users. Stuffit InstallerMaker makes it simple and effective. 

> Stuffit InstallerMaker gives you all the tools you need to install, uninstall, 
resource-compress or update your software in one complete, 
easy-to-use package. 

> Add marketing muscle to your installers by customizing 
your electronic registration form to include surveys 
and special offers. 

> Make demoware in minutes. Create Macintosh 
OS X and Macintosh Classic compatible installers 
with Stuffit InstallerMaker. 

Stuffit InstallerMaker 

The complete Installation solution!'' 


Prices Stan at $250 

To i(wn more, visit: 
stuffit com/ 
installermaker/ 


m\5ystenis 

www.stu£fit.com 
(831) 761-6200 

e 2002 Aladdin S,islen». 

Ific, SlylHf, Shiffll 
fnstdbrMok^^ ond Sluflll 
Engine SD4<: ore iredfliTKirki 
ol Alciddirb S/slems, he. The 
Aloddin bgo i» o regislered 
trodemofi. Al! oHwf prcxkicts 
ore trademarks or regtitered 
trademarks of Hwir respecriv« 
hoWen-. All Right* Reserved. 









IVIAC OS X 

PROGRAMMiniC 

SECRETS 


By Scan Knaster 

Interface Builder Tips and Tricks 


When you're prognamming with Cocoa, you spend plenty of 
rime in Interface Builder, instantiating objects, positioning things 
just right in windows, and making connections. In tliis iiionlii's 
columti, we’re going to shine the light of day on a few valuable 
tips and shortcuts for making yourself more prodtiiiive when 
using Interface Builder. 

Designing for Success 

Most of the intric’ate work in Interface Builder is in the 
design window, wliicli is where you add objects front palettes, 
lay them out, resize them, and so on. In this section, we'll 
discuss some tips for use in design windows. 

The firsi trick is useful for figuring out precise distances 
between objects while lcx:)king at them in the design window. If 
you select an object, then hold down the Option key, you'll see 
the exact distances from the Ixrrders of ihe object to the edges 
of the window (see Figure 1). 


0 e 


Window 


Enter youi favorite chee 

(-^ Stop Up } 


Resister arh t in your local elections. 


figure L Hold down OpHon lo see dislanees. 


But wait, that's not all. By moving die mouse* pointer while 
holding down Option, you can have Interface Builder show you 
the distance Ix^tween objects, rather than just die distance to the 
window edges. In Figure 2, the pointer ts on the static text 
object, and the window* shows the distances from the selection 
to each edge of that object. 



figure 2. Hold down Option fusee distances, 

You can use anoiher Interface Builder feature to make 
ol>jecis automatically resize or reposition themselves when you 
change the size of their enclosing window'. For example, let's 
say you w^ant to preserve the proptmional distance beiween the 
ilircc buttons in the window above: if you widen die window, 
you want the distance between the button.s to increase, lb 
make this happen, you can create springs lietween the ofijecLs. 
To do this, seleel each object in turn, open tlie size inspector, 
and click that line that you want to become a spring (a 
proportional relationship that changes automatically when you 
resize the window^. Figure 3 shows wdial this Icxjks like for die 
"Stop" button in the window above: we've clicked on its 
connection lines to make them into springs, do the same 
for all 3 buttons. 

Now, when we resize the window, if we hold down the 
Control key, the springs will cause the clistance.s lietween objects 
to change proportionally. If we want Ihe springs to l>e ignored, 
we can just resize without holding down ControL 


Scutt Knaster lias Ixx'n writing about Macs for as long as there have been Mats. Scott's books How lb Write Madntosh Sqfiu^re and Macintosb 
Prf}gmmming ,SecreL^ were required reading for Mac programmers for more tlian a decade. Scott wrote developer books for General Magic and worked on 
Mac softwaa- for MictoscjIl Stxxi's ixH>b; have been translatetl into Jap:inese and Pascal. Scott has eveiy issue of Mad magazine, which explains a lot. 
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UNFAIR 



Jt/Mac, the Mac OS X version of the Qt 
lultiplatform C++ application framework, 
rovides a uniquely unfair technological 
dvantage in software development. 



TROLLTECH™ 

Jt/Mac lets Mac developers develop in 
'++ on the platform they love most, while 
irgeting additional operating systems, such as 
(Windows or Linux. 


Qt/Mac offers; 

■ a fully object-oriented, elegant API 

■ single-source, multiplatform application 
development solution 

■ native compiling and applications that 
run at native speed 

I integration with Project Builder 

■ OpenGL integration 

■ native look & feel, such as Aqua style 


To evaluate Qt/Mac, visit www.trolltech.com 


Qt /MAC: THE UNFAIR ADVANTAGE IN C++ DEVELOPMENT 


© 2003 Tmllrech AS. AM trademarki, r<;guEerHl mil service nuirk^ arc the pr'Opcny uf their rcspti:[ivf All righu raervei 





Figure J. Stop button hm springs on its left and right. 


Spt^aking of the sv/i* inspecaor^ it's even smiiiter tfiiin you 
migliL hiivo railizcd. You am ty[5c math expressions into llic 
ctxjidinale Helds aiul let Interface Builder evaliuUe them for you. 
For example, if you want to add 32 pixels to an object’s widili, 
you am just clic k in the w field, select after the ciirrenl value, then 
type ”+32” and press return. Neato! Api)le even provides code to 
help you implement this trick in your own fields, lake a Icx^k at 
/Developer/Fxamples/l nterfaceBiiikier/Bns'yPalette for details. 

Another fun trick you can use with design windows is to 
see all the rectangles that Interface Builder uses to determine 
distances ix^tween objects. By using the Layout -> Show' Liyout 
Rectangles menu item, oy just pressing t'ommand-L, you can see 
all tlie layout rectangles at once, as shown in Figure 4. 

U L' .J Window 


[ toftr. yo j r. iavDtiJtfc xhcfiSfii . \ 


.Start. 


!r... .Stop ..^..jCUve.Up.^ 


Register mi vateMyour local etectlom. 


/i 


Figure 4. Design window with ail kmmt reciangles shown. 

Interface Builder tips aren’t all about layout. For example, 
there’s a quick way to set the lab order for objects in the 
window. You1l want to do this to alkiw users to tab from one 
text field to the next, llie tab order starts with the initial first 
responder, and continues from there by following each object's 
nexLKeyView rield. 


To Stan setting the order, select the oiijcct you want to Ixr 
tile initial first responder and choose Layout -> Keyboard 
Navigation -> Make Initial First Responder. Then, to set the tab 
order, ciioose l.ayout --> Keyboard Navigalion -> Sliow 
Keyboard Check, Controhdrag from one object to the next, then 
click Cormea in the cormection inspector, lliat will set the tali 
connection between the objects. Note that wlien you liave 
keytx)ard check turned on, the word lab appears at the Ixjttom 
left of the window. That reminds you that you can press tab to 
test the tab order. 

Coot Stuff m Ohier Windows, Too 
N ot all the neat tricks are in the design window - here are 
a CQupie you on use in the document window. Tf you elit:k the 
liny control on tlie riglii side of llie window, ilic object instances 
are displayed in an outline view, with the number of 
connections, both into and out of the object. If you click on one 
of these numbers, the connections appear in the window, as you 
can see in Figure 5- 
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► t^SWindow (CicKk Peefe rentes) 







Figure .1 Outline mew shows connections to an object. 


You can use this view to delete connections between 
objects. If you hold down Control and point at a line that 
t'onnecls two objects, the pointer clianges to a tiny fxiir of 
scis.sors, and clicking (you guessed it) cuts the connection. 

If you just want to learn more about the ccmnectecl objects, 
click on the name of the connecteci field, .sui:h as menu or 
J}anel in Figure S. The connected olsjecis will appear on the 
screen with a line between them. 

Thfre's More (Always) 

You ean find more fun and tiniesaving tips like these by 
reading the infonnative FAQ that comes with Interface 
Builder Gel to the FAQ by choosing FAQ in Interface 
Builder's Help menu. There's even a sense of humor in the 
FAQ: in the section on modifier keys, right after the 
descriptions of what happens if you pre.ss Command, Option, 
and Control, the FAQ tells you ihal you can use the Left Pedal 
to disengage the clutch. Cool. 
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^^ithout a doubtf the Premiere Resource Editor 
for the Mac OS ••.A wealth of time-saving tools 

- MacUser Magazine Eddy Awards 

“A distinct improvement over Apple's ResEdit." 

- MacTeck Magazine 

‘'Every Mac OS developer should own a copy of Resorcerer 
-Leonard Rosenthol, Aladdin Systems 

“Without Resorcerer, our localization efforts would look like a 
Tower of BabeL Don't do product without it!" 

- Greg Galanas, CEO and President, Metrowerks 


“Resorcerer's data template system is amazing" 

-Bill Goodman, author of Smaller Installer anxl Compact Pro 

“Resorcerer Rocks! Buy it, you will NOT regnd il." 

- Joe Zobkiw, aulhor of A Fragment of Your Imagination 

“Resorcerer will pay for itself inany times over in saved time and effort." 

- MacUser review 


“The template that disasseJiibles ‘PICT's is awesome!" 
— Bill Steinberg, author of Pyro! and PBTools 

“Resorcerer proved indispensible in its own creation!" 
- Doug McKenna, author of Resorcerer 






Version 2.0 


The Resource Editor for the Mac™ OS Wizard 


ORDERING INFO 


Requires System 7.0 or greater^ 
1.5MB RAM, CD^ROM 

Standard price: $256 (decimal) 
Website price: $128 - $256 
(Educational, quantity, or 
other discounts available) 

Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 

Payment: Check, PO's, or Visa/MC 
Taxes: Colorado custonnors only 

Extras (call, fax, or email us): 

COD, FedEx, UPS Biue/Red, 
International Shipping 

MATHEM^STKETICS, INC. 

PO Box 298 

Boulder, CO 80806-0298 USA 

Phone; (303) 440-0707 

Fax: (303) 440-0504 

res orcer cr#m ath eni aesth ctics .com 


• Very fast, IlFS browser for viewing file tree of all volumes 

• Extensibility for new Rcsorccrcr Apprentices (CFM plug-ins) 

• New AppleScript Dictionary (‘aete’) Apprentice Editor 

• MacOS 8 Appearance Manager-sawy Control Editor 

• Power Plant text traits and menu command support 

• Complete AIFF sound file disassembly template 

• Big-, little-, and even mixed-endian template parsing 

• Auto-backup during file saves; folder attribute editing 

• Ships with PowerPC native, fat, and 68K versions 


• Fully supported; it’s easier, faster, and more productive than ResEdit 

• Safe^r memory-based, not disk-file-hased, design and operation 

• All file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and opens/marks/selects resources by text content 

• Makes global resource ID or typo changes easily and safely 

• Builds resource files from simple Rez-like scripts 

• Most editors DeRcz directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 
•Its own 32-bit List Mgr can open and edit very large data structures 

• Templates can pre- and post-process any arbitrary data structure 

• Includes nearly 200 templates for common system resources 

• TMPLs for Installer, MacApp, QT, Balloons, AppleEvent, GX, etc. 

• Full integrated support for editing color dialogs and menus 

• Try out balloons, ^ictVs, lists and pop ups, even create C source code 

• Integrated single-window Hex/Code Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

• Relied on by thousands of Macintosh developers around the world 


lb order by credit card, or to get the latest news, bugfixes, updates, and apprentices, visit our website. 

www.mathemaesthetics.com 
















CASTING YOUR 
.NET 


By Andrew Troelsen, Minneapolis, Minnesota 

An Initial Look at the .NET Platform 


Exploring .NET development on Mac OS X 


Wia(X)ME, Skefocal Readers..- 

Building raw application infrastiTicture by hand is a time 
consuming, error prone and painful process. Who among us 
really wants to create yet another linked list, database access 
framework or user interface library? Tliankfully, numerous 
platform development kits exist today. By leveiaging APIs 
(application programming interfaces) such as J2Spyj2E£, Cocoa, 
and CarlHjn vve are able lo keep focused on the programtning 
task at hand by leveraging a set of canned functionality. 

As a software professional the chances are good that you 
are aware of a new devekrpmeni plalforni created by Microsoft 
named .NET (pronouneed, doi net). As well you may have 
also heard of a plethora of new pvograniming languages that 
target this new framework such as C# (sec sbar^j}^ Visual 
Basic.NET, managed C>+ and PascaLNET (to name a few). 
However, given .NET'S point of origin (Microsoft), you may 
have naturally a.ssumed that .NET development is solely the 
activity of Wintiows programmers. If you did make this 
assumption, you might Ik* quite suq^rised to learn that and 
the .NET platform are alive and well under Mac OS X, as well 
as other Unix-based systems. 

In this new MacTech .series, ii is my goal to jKovide a 
guided tour of the NE'E platfomi us seen througli tlie eyes of a 
Macintosh developer. Over the articles to exane, you will learn 
how to configure your development inachine(s) willi the 
necessaiy infrastructure required to build various types of .NET 
applications using multiple .NET distributions and .NE1-aware 
pn >graiTiming kmguage.s. 

To begin our journey however, we need to gain a higli-level 
perspeaivc of .NE'E itseT, which is the point of this first article. 
Please Ixi tmyaipare that all of the topics examined liere will he 
furtlKT explained and expanded upon in subsequent article.s. 
Given tills friendly disclaimer, kick hack with youi' beverage of 
c'hojc:e and let'.s gel to know ihe .NET platform. 


The Philosophy of ihe -NET Platform 

Tlie .NET platform is a software development API tliat was 
officially released to the programming world circa 200T Despite 
the name (which tends to conjure up visions of Web-enabled 
front ends), tlie NET i>lalibnii can Ik used to build traditional 
desktop applications, 'lerniinal applications as ml! as sc:T\^cr-sid^ 
Web applications and XML Web services. 

Like other frameworks, .NET provides a class library dial 
allows developers to l^uild various forms of applications. Not 
only does this l>ase class library enaipsuiate various primitives 
sucii a.s iiirc‘ads, object serialization st^rvices, file 10, and 
interaction witli various liardware devices Csucli as [)rinLers and 
handheld devices), but it also provide.s support for a number of 
services retiuired by most real workl applicalions (e.g. GUI 
Loolkit.s, X.ML manipuiaiionj network pix>ioct)!s and so forth). 

However, unlike many other rramewurks, the .NET base 
cias,s libraries may i>e accessed using numerous programming 
languages. Not only can developers pick their programming 
language of choice when building .NET soluiions, but tliey 
may also create a single NE'E application using multiple 
languages. For example, you could make use of C# to build a 
desktop a|)plication which communicates with a XML Web 
services written using Visual Basic.NET. Even more 
interestingly, .NE1' supports cross-language inheritance, cross¬ 
language exception hantlling and rro.ss-language interface 
implementation. Given these traits, you will do well to view 
■ NET as a kingnage-agnosiic franiework. 

In addition to I King a language-agnostic: development 
platform. .Nin* is also platfonn-agnoslic. This tidliii is the one 
aspect of .NITl’ that tends to surprise most clevelopers. While it 
is tnie that Mterosofr Corporation has never been in the business 
of building s()ftware dial can (Lxi.sily) run of multiple ojK-rating 
systems, the tides have turned with the release of the .NET 
platform. Like J2SE, tlie .NET plathirm allows you to build 
software that can execute on multiple operating systems without 
modification. Therefore, if you build u .NET-based program on 
your Macintosh G5, you are able distribute and execute this 
applicaiion on any operating system hexsting the .NET runtime. 


Andrew Troelsen is a seasoned ,NHT developer who has authored numerous books on the tcjpie, including the award winning C# and the NET 
Platform. He is employed as a full time .NFT trainer and consailtam for fnterteeh Ijearning (wwwJ lie rtech learnt rig .com) and spends his idle moment.s at 
work showing off his fancy new Mat iniosh PowerBtJok G4 to his envious ct>horls. You can eonlacl Andrew at aTroelsen@mac.COm. 
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Complete Sourte Control 

cbttttstn^ the WKtrid 

^ sftftwoK dbt.v€Utpment 

and Oefett Mauagemenl 


for Mat OS X 



Effective source code control and defect tracking require powerful, 
flexible, and easy-to-use tools—Surround SCM and TestTrack Pro 


■ Complete source code control with private 
workspaces, automatic merging, role-based 
security, and more ^ 

• Comprehensive defect management — track 
bug reports and change requests, define 
workflow, customize fields 

• Fast and secure remote access to your source 
files and defects — work from anywhere 

• Advanced branching simplifies managing 
multiple versions of your products 


• Link code changes with defects and change 
requests — know who changed what, when, 
and why 

Scalable and reliable cross-platform, 
client/server solutidns support Mac OS X; 
Windows, Linux, and Solaris 

• Exchange data using XML and ODBC, extend 
and automate with SOAP support 

• Licenses priced to fit your budget 


Seaplne Software Product Lifecycle Management 
Award winning, easy-to-use software development tools 


Surround SCAff 


Seapiftt 


ioftwaro 


13th annual 
product 

sxcellenice 

aiVHrr; 





TestTrack 

PRO 

nil pfodutf narnes Istd are regisref id trcderruirks of feif respectivf owners, iB rights reservsd. 
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Down/oad Surround SCM 
and TestTrack Pro at 
www.seapine,com 
or call 1 888-683-6456 








































The BtJiti>iNG Bi.<x:ks of .NET 

Cltrarly^ a language and ]’>Iatform neutral plaift>rm .sutth as 
.NET is founded upon a numlTer of well-defined rules and 
underlying technologies. Given this, our next task is to preview 
(the operative word t3eing pwmew) st>me key and interrelated 
specification.s that make it all possible! the Common Umguage 
Infritsiructure, the Q>mmon Type System and the Common 
Language Specification. 

The Common Ijinguage Infrastructure (CLI) 

First up, we have a specification termed the Common 
Language InlTa.stnictiire, or simply CLL This particular aspect of 
.NET is the foimclatir>n upon which the platform and language 
indcjxindeni nature of .NET is established. Ihe CLJ Ls a fairly 
large specification tliat fonnaliiies several critical eletnenis of the 
platform, including: 

• An al-wtract aintime engine icTiiied ilie Viatial Execinion System 
(VHS), whicli Is atpiible of hosting .NET cxjmpiiimi code lil>raries. 

• Tlie internal stmciiire of the ^NEF compliant code libraries 
(which go by the name msemhlies) to lie hexsted l>y the VES. 

• A tmified tyfx^ system termed tite Common TyyK* System 
(CTS), which describes the rules used to compose the 
prograntjning types ct)nlained within .NET assemlilies. 

• ‘the syntax and semantics of the low-level language used to 
implement the* types contained W'iihin .NlTf assemblies, 
termed the ra)mm(3n Inlermedlate Lmguage (CIL). 

The VHS is a hypothetical execution engine ihai sits on top 
of the aclual undtTlying operating system (such as Mac OS X or 
Windows XP), The [)riniary n>le of the VES is lo kmm, load, 
execute and manage .NET code libraries (a.k.a. asscaublies) on 
your Ixdialf. As well, the VES takes care of a mtmixr of related 
details such as automatie memory management (via garbage 
collection), language i[i[egratioii, ensuring type s;ifeiy and 
verifying the correaness of die assemlily's CIL code (more on 
C^IL a bit later in tliis article). 

One a related note, if you do liave some experienc*e itsing 
Microsoft’s official .NEf platform, you may have heard of 
another term: the Common Linguage Kimfime (CLH). Basically, 
the CLR is the fonual naiiie given to a VES implemeniation that 
is specific to the Windows family of operating systems. Given 
that we are not all that interested in the Windows-centric 
implementation of the CLI's execution engine, I'll stick to the 
more generic term ’VES^ when refeiTing to tlie execution 
engine of .NET 

rhe Common Type System (CTS) 

The next building block of the .NIT platform, the 
Common Type System, or (TS, is concerned with formalizing 
the structure of the ty|>es contained within die canle libraries 
themselves. Simply put, ihe C'^I'S specifies all of the pos.sible 
data types (e.g, Booleans, string.s, integers, etc) and 


programming construm (eg., iteration constructs, virtual 
methods, overloaded operators, type constniciors and so on) 
supported by the .NET runtime. 

One of the most fundamental mies of the CTS is the fact diat 
every .NE"!’ type derives from a common Ixisc* class named 
System.ObjeciL. For your edifiaition, Listing 1 shows the C# 
definition of diis to[>must class type: 

LisLing l:TIic C* of ttit iiltinutc .NET ha.se da.ss 

namespace System 

t 

public class Object 
I 

public Object(): 

public virtual Boolean Equals (Object obj): 

public virtual Int33 OetHashCodeO: 

pubiic Type GetTyped: 
public virtual String ToStringd; 
protected virtual void Pinal ts:G() i 
protected Object KcmherwlseCloueO i 
I 
I 

At this point in rhe game, donf wony^ if you cannot make 
iieiids or tails of previous code listing. Tie point here is that the 
Cl>? is the asixct of the CLI that descrilxs a set of rules that 
constiuiie a weil-tlefineil .NIG' ty-pe, one such aile lieing the fact 
that System.Object is the irosmit' super class. As you would 
hope, other rules of the (TS and the role of System.Objeci (not 
to mention the programming language) will lx ejutmined in 
great detail at a later lime. 

rhe Common l.anguage Specification (CLS) 

Understand that a pantcular .NEf language (such as 
CCfBOL.NET) is not rtiquircd lo support each and every a.spect 
fomialized by the CTS. For examjjle, alihough the (TS does 
define how^ unsignetl tlata tyjxs are to lx represented in CIL 
and processed hy the runtime engine, not all .NE'I' languages 
support unsignetl data. Given that .NET is a language-neurral 
platform, it would be quite helpful to have a well-defined 
baseline of functionality. Hie Common Linguage Specification 
(CLS) is effectively a subset of the Cl'S, which defines a set of 
tiata types anti programming const ruct.s that all .NET Hinguages 
can agree ufx^n. 

When you huiki .NIT a.ssemblies that only makes use of the 
guidelines expressed hy tlie CLS, you can rest assured llial your 
code library can !x! correctly used by any .NET language (such 
ct>de is termed CLS compliant'}. On the other hantl, if you build 
a .NET ccKle Itbraiy' dial makes use of features ouLside tlie realm 
of tile CIJS (but within the confines of the CTS), you have just 
cTuated an assemlily that may only he* completely usable from 
select ,NET programming languages. 

To solidify' the concepts presented dius fan liguie 1 
illustrates how various .NET programming languages ultimately 
targe! the VES and CTS/CLS s[x.*t:tfical ions. 
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.NET Type Meaning in life 



rill.' (Ipvriitiii^ S^>sti'ni 

(Mmc os X, Winck>vvs XP, I rtJcIJSD, vimous iliKtnbtitUHis) 


I'igure /. ^NKTprogramming languages targei the .NFT 
pialform. which is huUt ufKm numerous simJficaHom. 

Now ihac yoit have a IxHter idea reg;irding liic role t>f ihe 
CLI, let’s dig into some Fnrtht^r details of die .NIH" type system. 

Tiie Type System of .NET 

Every programming language (and therefore every 
programming plaLlorm) exposes a 'type sysfem\ This term 
boils down to the set of syntactically well-formed user 
defined types (UDl's) supported by said language (or 
plathrrm), 'fo illti.siraie a well-know type system, consider 
Java. As of Java I A, the type system consists of class types 
and interface types. Beginning w-ith Java 1.5, the type system 
will he expanded to inelude C-slyle enumerations. In a similar 
vein, (he C++ prograjiiming language supports a lypt? sysieni 
consisting of the set Iclass, enumenitioa, strucuireh with 
interfaces being simiilaied via class types and a 
corresponding lypedef or two. 

.NET also defines a set of p<)ssii>le types, w'iiith have you 
have .seen is oflkially termed the CTS. As you woultl expect 
fmm a mtKlern day API, this tyjx system is extrtant^ly well 
organised and completely object oriented (including su()[K>rt for 
a relatively new programming paradigm tenned aspect oriented 
programming). 

'lb illustrate the symmetry of the .NHT typr^ .system, |xaider 
the fact thal every single llDTs provided f>y the .Nirf platform, 
including any custom software entities you create yourself, will 
fall into one of tlie following categories: 

• Class 

• Interface 

• SiRiciure 

• Enumeration 

• ^)t^legale 

While these type categories will be fuUy explained in later 
articles, liible 1 olTers liigii-level definitions for each meinlKTof 
ihe .NFF type system. 


Class 

Class types arc heap allocated entities thal may b<’ 
extended and mixiified by tlerivixl classes. .NET 
dasst*s am very similar to Java, C++ and Oh|ective C 
das.s types. As you know, classes form the lm.si.s of 
the famed ‘pillars of OOP' (encafisnbtion, inheritance 
and polymorphism). 

Interlace 

An interface is a coEection of absimtl memlx^rs 
grouped by a particular name. Using interfat'es, 
developtTs are a hie ri> establish polymori^hism 

1 let ween lyfx^s mU related by elassteal inheritance. 

Struciuaf 

Structures Are liglilweighi, stack-allocated entities that 
are well suited for intxleling numeric, geometric and 
aioniie user del med lyj>e.s. 

Hnumeraiion 

Enumeratiims (or simply, enums} are a named 
collection of name/value fxiirs. 


IX*legatc By far and away, .NFF delt;gate.s arc the mcxsi 


ion founding “typt' of type' to conicnd witir For now 
I will simply define ,NE"J' delegates as nothing more 
than a tyfie-sale and objetl oriented function poinicr 
(more details to come in later articles). 

Table I* Ihe .NFT tyjK* system 

Given that .NET provides many ihous;tnds of predefineri 
types (ciillecLivdy termed the Ixise class lihrEtries' t)r sitnply 
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BCD, you will Ik* liappy lo know th^t like-mindec! types arc 
organized into a conceptual Ixjundary tcnncd a namt^pace. 

UNDliRSTANDlNCi .NET NAMKSPACES 
Tite namespace concept is not new. The Java, C++ and 
SinallUilk languages have used similar (but not idenLical) 
ctmeepts to piirlition types for years. In a nutshell, a ^NET 
namespace is a coilection of scn)antk:ally related types. For 
example, rhe System.Co!lections namespace contains a set of 
cla>sses. interfaces, enumerations, stnictiires and delegates lliat 
represent *types that manage other types’ {e,g. linked lists, army 
lists, FIFO / FIFO types and so on). The SysteiiLData namespace 
defines numerous types that have to do with database 
nunipulations. Table 2 dcK uments st)me (I’Jiit hy no means all) 
interesting .NhT namespaces. 


,Nirr namespace 

Meaning in l.ife 

System 

Tlie System namespace tleHnes various 
('ore ty|Tes ytai will use on a day-to clay 
Irasis. Here you will llnd the native .NFri' 
data lyix's. core exceptions and numerous 
uiility tyfxs. 

SyMein. Q >1 lectio ns 

As mentioned, flii-s namesi>acv deRnes 
types that can contain and manage other 
ty|x*s (e.g. ArrayLisi, Stack. Queue and so 
on). 

System.n:il;i 

Ihc ,Nirr platform tiefines numerous daui’ 
centric mime.spaces that allow you to 
inierati with various relational dautixtscs 
System. Data i.s the lowest comiiKin 
denominator for data access under .Ntni 

System.Drawing 

'Hie tlrawing-ieniric name,spaces allow you 
to render graphicil data to a surt'ace (such 
as window of a desktop application or a 
region of memory). 

SyslemJO 

Defines types to work with variou.s 
inpui/ouiput streams. 

Sy.stcm.RcFlctlion 

The reRedion namesp^ices allow you to 
prtJgrammiitically di.s<’over the runtlitmality 
of type's (as well a.s generate new iy]x'.s) at 
runtime. 

Sy .St cm, Ki] n 1 1 me. Re moti ng 

.NET tlcRnes nu inert ms names|races which 
;illt)w you to build distrihuted applications. 

System.Weh 

Tlie Welj-centric namespiices allow^ you to 
huiliJ Weh-lxiset.1 iif>plicati(Jns (ASP.Nirf) 
and XML Weh services. 

System. Wintk ws.Forms 

Window's Forms provides tyjxs that alk>w^ 
you to build iradiikmal desktop 
applications. 

System .Xml 

As ytm would hope, the .NtH’ jilatfonii 
defines numerous namespaces that 
facilitate the manipulatitm of XML data. 


Table Z A mrnpHng of .NET namespcices. 


Interacting with the Base Class Libkakies 
Regardless of which sort of application you intend to build, 
you will inevitably interact widi numerous .NET namespaces. 
I Jowever, the way you programmatically denote the namespace 
you wish to consume will differ l>ased upon your ,NET 
programming language of choice. If ytju arc using you 
would make use of the using keyword to s[K‘Cify the namespaces 
you wish to use. For example consider Listing 2: 


TjsiIi^ 2: Spcdlyilig Ei^ncspaces in C# 

// My way tixrf C# 
using System: 

UEing System.Windows,Forms; 
using SyKTcm,Drawing; 

public class MyApp 
t 

//'IbUu:Add »>mc interesting code... 

On the other hand, if yon would rather build your 
application using Visual liasic.NET, you use ihe Imports keyword 
to acliieve rhe same a fleet, as .seen in Listing 3: 

listing niijiicjfpaccs in VB.NEr 

' My coni Vl^uai Raj^k* NET pntgnim. 

Imports Systent 

Imports System,Windows.Farms 

Inports System. Drawing 

Public Class MyApp 
"JbJXjiAdd some intcmrting cocic. .. 

End Glass 

In either ctise, once you declare the namespit^es you wish 
to ctjasiime, yon are now able to access each of die types 
defined will tin the System, System, Windows. Forms and 
System.Drawing namespaces. 

The Fully Qualified Name of a lype 

It is worth [loiiUing out thai explicitly specifying the 
namespaces you wish to interact w ith u.sing a language specil ic 
keyword is lecfmically optional, lo imdersiand why tlds is die 
case, allows me to define the term fully {pmlifte^I name. As you 
have already seen, all .NEl' types live within a namespace 
definition. Tlius, if you %vish to make use of the Array List tyjx- 
deRned in the Systeni-Collectioiis namespat e, you might author 
ihe Ft>l lowing code (listing 4): 

listing A: t’sing rhe Amiylist lyjx' via ruuntr»p;icc rcfcfenc(;?» 
using System. Col I ectlonifi 

public class MyClass 
( 

public void Sometlethodf) 

I 

//Add Mime to an Armyli!^ 

.ArrsyList arUist * new ArrayListO; 
arlist.Add(12): 

arList. Add(''Doti* t forget wife*s birthday"); 

I 

1 
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Three High-Performance Applications 


Thinkfree Write 

Thinkfree Write is o powerful word processing applicarton 
rhat enables you to create rich, professional quality 
documents and Web pages. You can Insert tobies, 
images, arid dipart, or even apply custom layouts to 
your document...then effortlessly proofread your work 
with the easy-tO'Use spelling ond outo-correction features. 

TKinkfree Calc 

Thlnkfree Calc is a full-featured, easy-to-use spreodsheet 
application that can easily tackle the most complex 
analytical tasks with over 40 charts and 300 function 
capabilities. Thinkfree Calc opens, edits, and saves 
directly into the Microsoft Excel (.xls) formot, so users 
can seamlessly share documents and collaborate with 
Microsoft Office users. 

Thinkfree Show 

Thinkfree Show enobles you to create high-impact 
presentations including animation effects, drawings, 
images, clipart, and other graphic features. Thinkfree 
Show opens, edits and saves directly into the Microsoft 
PowerPoint (.ppt) format. 

CyberdrivePlus 

A free, one-year subscription to CyberdrivePlus is also 
included. CyberdrivePlus provides you with secure, 
Internet File storage ond free online software upgrades! 


ONLY 
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while you will typically always prefer to explieiily list 
ihe namespaces used by a given source code File, the 
[)revious code is nothing more than a short hand notation 
For the following code in Usiing 5 (note the lack of a 
using statement): 


listing H: Namespaces cuntaln any numlxT of .NET types 
namespace MyCustomTypes 
I 

public class KyClass |_| 
public class KyOtherClacs l^| 
public enuiD HyEniin |_| 


listing 3:lJ!i3iigArniyUst V'ia the fully quaLiricd name 

pub1Ic class HyClass 

I 

public void SoroeHethod() 

I 

//Add some data to an Airaylist. 

System.Collections,Ac rayLlst a cLlst 
= now SysteinXoll^*cf-Ions. Array List (): 
arList.Addf12); 

orLlsl♦Add("Don'i forget wife's birthday"); 

I 


As you cun gut her, I he fully (juulifieti name of a type is 
simply a term used to identify a tyt>e [jrefixed by its defining 
namespace. While making use of fully qualific*ci names may 
make your code painfully w'cll dcoimentetl. hand cramps im 
sure to folltiw. Given this, most ptxjgramtjicrs f>refer to iisi ihe 
set of namespaces used by a given file using a language s(x:cific 
keyworti. 

hi leniis of fieri onnanee, iliere is absoiutely no thlference 
whatsf)ever IxMween identifying a type with the fully cfualified 
name or via a namespace reference. As you wiii see in ju.st a 
bit, the .NbT plalfonn aiim}Ks refers u> a tyjx’ u.sing it.s fully 
qualified name. In this light, the namespace ctmcepi is simply 
a typing time saver. 

If you liave a background in the j2SE platform, understand 
that the using and VlkNE^f Imports kcyw(jrd tio no\ support a 
Java-style * notalion. if you wish to access nested namespaces, 
you must list oui each nested namespace in turn. Itius, tlie 
follow'ing aide is syntadically correct (Listing (r): 


listing 6: Nested njuicsfiaces must fx- listed explkitl) 
// Making use of iltn^c drawing n^latcd rianR'spaee^i. 
ualng System♦Drawin;^: 
using Systf*iit * Dcswlng ♦ Brawl jig2D; 
using System^Brawlng.Tmagln^; 

While die following java-like notalion (listing 7) will nuise 
a compiler error issued by the compiler: 


Liiiimg 7:Java-like * synUx not supixuled in O! 

//Orjps! Hemcnihc r is not Java! 

Uiiing Syi^tcra.Drawing. *; 


Creating Custom .NET Namespaces 

In addtiion to programiTiing wnih the namespaces dellnetl 
by the .NCT base class libraries, you may tie!me your own 
custom names[laces as well, iiy way of a simple example, 
as.sume you have defined two cluas tyfxrs and one enumeration. 
To group these: items into a namespace definition, you could 
write the h)lk>wing C> cxxle (Listing 8): 


'ITie airresponding VliNCT code exnmt>le Ls quite similar 
(Listing 9): 


Namespace MyCustornTypt^ 
Public Class MyClass 

End Class 

Public Class HyOtherClass 
End Class 

Public Enutn MyEnura 

End EnLini 
End Namespace 


Usting 9: Ditto. 


If you wish to use these lyjxs from amnher namespacre, you 
would simply make use t>f the correct language specific 
keyvvt>ai uscxl to reference ;m external name.space. For example, 
in we would write ihe following (Listing 10): 

Lbiiinp U): Hcffrcncinp a custom namespace in C* 

using HyCustomTypse: 
namespace KyNewNajiieapaco 

I 

public class HyNcwGlusa 
I 

//VtJU ran now make use td any <d die types In 
// die M'^Cusicmil'i'po namespaei.' 

I 

1 


So much for our rniiial fiigli-level overview of the ♦NF'l' type 
sy.stem. At this point in the game simply undersumd that the 
.NRT type .system coasists of the set Iclass, interface, 
enumeration, structure, tlelegaitl and ihat semantically related 
types are groupeii t«>gether using the tiaiiies}>ace ctmcepi. Next 
up, lefs check out funher details regarding the language 
agnostic nature of ihe .HKV plalform, 

.NET IS A Iw^NGlIAGB ACNOSnC PlATI OBM 
As menlitjned, tme distinguishing aspect of the .NF'f 
platfonn is the fact tiial developers may tnakc use of any 
t'omliinarion of programming languages to access the tyjyes of 
the base class libnmes. MitTosoft itself has created five ,NF1- 
awarc programming languages: C>, VT1NE7', managed C++ 
and [Script. Ntri. While C# and Vli.Nin* tend to steal most of the 
sjKJilight, there are literally dozens of languages which can lie 
used to interact witli ilie .NET lilimries. Consider Ihe partial list 
offered by Table 3 (please note tlial the exact URLs are suljjecl 
to change in the future). 
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.NET Aware Programming Language 

Meaning in Life 

(kfmjxmcm Pascal 

hup ://w w W', ciU, q ut. eil u .a u/rt^si^a nh 

/plas/projeci.s/index.j.sp , 

Pa.scal language 
bindings Ibr.NEr 

laffei 

hup: //arch ivc. cilfo 1.«>n Vdt k / i i ra r n ja Ls/ 
icc’hnology/dt niHM/cifTdsforp 

Eiffel language 
bindings for .NtT'. 

IValnm 

hu p://w w w, la hc 7 -c om/l170/1170. hr m 

port ran language 
bindings fix ,NfT 

IVfl and Pylhoii 

hi t p;//:i sp n i vesiatc.cT nn/ASPN/N h"L 

Perl and ITthon to 
.NEL language l>indings 
are al.sci available. 

,Schcnic 

f lit [ >://n) vL*r.r?4 Ji wu .edu/ -'sc \if nic 

11i€ Scheme language 
is supfRirlt^l under the 
.NET platform as well. 

SmallSiTipt (a.k.a., 

1 1 1 i\rJ / w w w, sma I Iscript. net 

Yes, even Smalltalk 
supports hinditig To fhe 
.NTT platform. 


Table JL A ffarHal UsHug oJ\NtTaimre programming^ 


Whcfi developer's first learn alxjut the language agnostic 
ASpciA of the .Nlir platform, various c|uestioiis lend to surface. 
One such t)uestton is more (>ractiail in nature, and tends to go 
someiliing like this: '^If all languages targeting .NET have access 
to the same libraries, why do wt? nt^ed more than one language?*' 
'llie ccjrresponding pr;tt lical answer is based on the simple faci 
that programmers tend to l)e very particular which their syntactic 
prcreiiences (myself included). 

Some developers love to see curly brackets and semi-c'olons 
galore (as seen in C-bused languages such as Objective C++ 
and java). Others [^efer more 'hnman-readablc' syntactic tokens 
as found in the BASIC family of languages. Given the philosophy 
of .NHl', we area able to stay true to otir syntactic preferences 
while accessing the .NEl' ixise das.s hl)rarics. 

lurthermore, rememlKT tlte obvious fact tliat each 
prognimming language lias iLs own set of strengtlT-s and woknes,scs. 
St)iiie l^mguages htive excellent native supfxjn for adviuicxixl 
matliematical processing, while oilieis excel in the realms of 
firumtial or logical pnxessing. Ag;iin, using .NEl* you cm capitalixe 
y[x>n iJie utiique aspects of a given language while interacting witli 
tile fitbiic provided by the .NET ixa.se class libraries. 

Tim Role of -NET Assembuf^s 
Obviously, knowing how to develop witli a particular .NEl' 
prcjgramming language (or two) Ls only part of tlie process. Once 
you have aulliored ytxir .NEE source code files ifiat define your 
namespiices and tlieir contained types, they are fed into the related 
complier to pr<xluc:e a binary file teniied an assembly. Assemblkfs 
are platform-neutral binaries bit>Iis that contain generic' ck'sc'riplioas 
of types and their implementation that are hosted by die VES. To 
Ix" more sptx ific\ a .NET assemlily is a unit of tk'ployrnent that is 
cximposexl of die Ibllowing three ingaxlienLS: 


• Common Intemiediate Language (CIL) 

• lyjx^ metadata 

• Assembly-level metadata (termed the manifest) 

Again, later articles will drill into the details of ,NEr 
assemblies, CIL cxide and metadata, Llowever to prime the 
pump, lel^s see a simple example which illu.strates the basic 
compexsidon of a ,NEr asstmibly. Assume wc have the following 
C> .source ctxie file seen in Li.stiiig 11 (note that by convention, 
C> c'ode files end in a ’xs file exten.sion): 

tisltng I LA invid .MM' irttdu tile (in Of} 

it MyC'SbarpApp.cji 
using System; 

nattiespac? AilMyStuff 
I 

pubiic class HyCSharpApp 
I 

public void EchoToTerininal(siring acssage) 

I 

Consolc.WrlteLinaC'You said: lOl”, 
message): 

I 

I 

I 

Rven if you have never seen C# code lielbre this article, the 
pfC'vious code example should not niise 1 <k> many eyebrows. 
Here we see a das,s iyf)e with a single methtxl named 


Presto Vivace, Inc. 

Fast and Lively Public Relations 

Presto Vivace specializes in public relations 
for small technology companies. Our press 
contacts database is now available for 
companies to manage their own publicity. 

For only $99, you can use our professional 
database to place your press releases. 
Available in AppleWorks format; e-mail 
marshaU@prestovivace.biz for sample. 

4902 Powell Road, Fairfax, VA 22032 
703/426-5876, fax 426-5892 

http://www.prestovivace.biz/ 
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EchoToTerminaK), whitli takes a string type as its only panimeter. 
This meih(Kl is implemented to take the incoming ar^tinienl and 
print tlie eonlents io I he Macintosh ‘lermtnaL Notice tliat die 
WriteLineO nietltod of tlie System .Consol© type takes a literal 
string at^iimeni containing an optional (and strange) token {0}, 
wliicli is dynamically replaced by the specified second 
argument. Ft>r the time Ijcing, simply regard this notation as a 
kinder, simpler version of the C printf() function. 

Once this source code file has been processed by the C* 
compiler, we end up with an assembly, which for the sake of 
argument, we will name MyCSharpApp.dlL Although the file 
extension of a .NET assembly can technically be anything 
you choose, you are likely to find two common extensions in 
use today. If you have a .NET assembly ending in the 
extension *.exe, yoti are looking at an executable program 
that can be directly loaded by the VES. On the other hand, 
assemblies which end with a *.dll file extension are dynamic 
link libraries which cannot run in and of themselves. Rather, 
*.dll files are loaded on demand my other running 
applications (very similar to the *aiylib modules found under 
Mac OS X). 

The Guts of a -NET Assemfily 

As you will see in tlie next article, .NET distributions ship with 
a Ux>l named ikiasm {the CIL disiissembler) wliich can lx* used to 
view die underlying CIL ttxle, type meiatlaia and assembly 
manifest cxjntained within a given .NEl’ asstanbly. I^or OLir cunent 
clist'ussitin, we are only concerned with itie ink^mal representation 
of the EchoToTenminalO memlvr, as seen in Listing 12: 

UsMn^ 12: £i;hu'lbTcrntiml() express'd in (aLc<xJL‘ 

.method public hidebyslg 
inststvee void EchoToTerminal 
(class System.St ring message) cil managed 

I 

.muxslack 8 

Idstr "Tou said: lOI" 

caJ.1 void [mficorlihl 

System.ConEole::Wrltebinotc!ass Syalcm.Strlng) 
ret 

) 

Without gelling Itxi Ixiggtxl down into the details at this jxrint, 
simply nolitxf how the C# imjilemcntaijon of EchoToTerminalO has 
Ixxtn processed by the C> compiler into temis of CIL axie. As you 
may have alrt^^idy guessed, the Idstr (.:IL operational ccxle IcracLs a 
string for use, while call is u.sed lo invoke a tyfie niemlTer (in this 
case, the WriteLineO method of SystenLOin.solc) with the ciirrenrly 
kxided aiguments. Finally, the ret o|x*naional code is the CIL- 
s;tvvy way to return fnini a methcxi. 

Now' assume we have im[)lemented ihe sjime exact class 
type using VIlNFri' as shown in Listing 13 (liy convention, 
VB.NET source code files end with a *.vb rile extension): 

[.isting 13: A trivial NiT siniRc code Pde: titi VB.NLT) 

'MyVbNetApp.vb 
ItnportB System 

NaroeBpace AllMyStuff 

Public Class HyVbHeiClass 

Public Sub EchoToTermlnal(message as String) 


Console.yriieLlneP'Yoy said: tOl*. message) 

End Sub 
End Class 
End Neiaespace 

Once this sotirce code rile is prex'essed by the VB.NFL 
compiler, we ran again use ildasin to view the resulting CIL 
gencratexJ l>y the VB.NET compiler (Listing l4): 

lisiinK [ 4 : PchoToTcnmimlO tTtptx'sscd in CIL code (yvl again) 
.method public htdehysig 
instance void EcboToTenainal 
(class System.St ring message) cil managed 

( 

.mnxsLack B 

idstr “Ifou said; EOl" 

idarg.l 

tali void 

Imscorlib]System.Console:lyriteLlne( 
class Synteot.St ring, class Sysiem.Obiect) 
ter 

J 

As you have ju.st seen, regardless of the fat:t that different 
.NET-awaa^ prognimming languages define unique keyword.s 
and programming idioin.s, the as.scK'iated compiler transforms 
these tokens into a common language (CIL) whic:h is injected 
into the binary' assembly. While it is true ifial individual .NET 
code compiicni are free to take some liberties regarding the 
ininsfonnation of their symuciic tokens inio CIL, the fact remains 
that as far as the ,NF;r mmime is concerned. CiL is the only 
language wonli s|it^ikmg and the only tme language processed 
l>y the NET runtime engine, 

'fo wrap things up for this first article, we close with a 
further examination regarding the platfoniKignostic nature t>f 
tlie .NET plaiform. 

-NET LS A Platform Agnwik: I^tform 

I laving a hmguage-agnoslic .NkTr assenilily dexfs little gixxl io 
anyone unless it can be loaded, executed and processed by a 
nmtime engine. As notetl earlier in llii.s article, tiie Virtual 
[ixeculion System (VF.S) is the entity in charge of hixsting a v;ilid 
.NEL a.ssembly. In addition to lx.‘ing a language-agnostic platform, 
.NET Ls alsT) pkitfomi-a^cnmtk. If yiHj have any ex[X.Tierice wiifi 
anything lelaied to Micrrxsoh, this last siatenient is sum to resoruiic 
a.s a flat exit lie. However, as strange as if may seem, while 
Mi(:ro.s<)ft wa.s cieveloping their official .NET dislribuiion, a team of 
engineers created an alternative implementation of the <^LI (tenried 
the Shared Sotirce CLll lliai may Ixj aimpiled and run on 
numeniys openiting systems (inciuding of aiurse, Mac OS X). 

Altliough lhi.s article has provided a higlelevel exaniinaiion 
of select elements defined by ihe CLI, the oft)cial dtRajments are 
available in Microsoft Word formal at 
hup://msdn.microsoft.com/net/ecma/. If you would rather 
obtain the ]T)F versions of these same documents, navigate to 
http://www.ecma-mternalionaLorg/pu!>iiorinns/sTandards and 
Icx^tre the following two documents: 

ECMA'334: Tlie formal specification of the C# programming 
language. 
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K(;:MA-335: ITie formal speciftcation of ihc .NEl' CI,I. 

Yl's, it'.s true. "Hie Microsoft CU docuiiients have been 
subniitted to ECMA as an official standard. In fact, the CLl was 
developed in conjunction with a nnmlx^r of key industry players 
(sucli as Intel and IBM). 

ECMA-334 defines the syntax and semantics of &. 
While 1 certainly encourage you to tjfMain and read ihis 
document do he aware this is a mtlier academic treatment of 
the subject. Keep it handy for a rainy evening or a sleepless 
nighty however do know that you will come to know the 
details of the C# programming language over the eourse of 
the articles to come. 

ECMA-335 is a vei 7 critical document for all of ihose 
interested in understanding how^ the .NET platform can fie 
ported to diflerent operating systems. As well, this information 
is also quite helpful for tiK>l builders who wish to btiild 
compilers for languages that target the .NET platform or geeks 
like us who are interested in technology. 

Given that ECMA-335 is quite lengthy, it has been 
sulxiivided inio a sei of partilioris, which is simply a fancy and 
overly verlK)se way t)f saying sectiom. Table 4 explains the 
content found within these ]>artition documents. 




Partition of the ECMA-335 l>ocuraent 

Meaning in life 

Piiitilion 1 Archiimtire 

Describes the overall 
ardiilecLure of the CU, 
iiititiding the niles of the 
CLS, the .NKT lype .'iy.stem 
(CIS), and the virtual 
excculityn sy.stum (VKS). 

Paititicjii II Mtaadaiu 

De.senhe.s how .NET types 
land their nicmiKT.s} are to 
lie represt^nic^l in lemis t>r 
.NET metadata. 

Partition 111 CIL 

This document dcscrihes 
alt of the gory tieiails of 
the Cxjinmon Intermediate 
Language tClL). 

1 Partition JV Library 

Gives a high level 
overview of lire minimal 
and complete class 
lihrarics that must he 
supported in a .NlTr 
disirihulitjn. 

Partition V Annexes 

A collection of 'otkls and 
enfis' thiiT deJvtnihe tias,H 
library de.sign guidelines, 
as well as the 

implementaiion uf ilasiu 
(the CIL assembler utility). 


Tabfe 4 A hreakekmm of the HCMA-33'? sixxiifkaf ion. 


Always rcmcmlier that at its core, the CLI is effecLively lilde 
more than a set of white papers. All of the specifications set 
fbnh in these standards documents are of little pnicrical use until 
ifiey arc* given life in terms of a physical c<^de l)ase. To date^ 
there are many iin[)lementations of the standards defined by the 
CLl. Some of these CU distributions liave indeed come from 
Microsoft proptT, which as noted, are mtlier Windows-centric in 
that they leverage certain aspects of the Win32 operating system 
that are simply nc^t found on other systems. 

Lucky for us, there are a number of additional CLI 
distributions that have no ties to Microsoft (or the Win32 Al^lsj 
beyond the fact that die original specifications have been 
('onsulred as a foiirsclaiion. Two of ihe most popular open 
source disiriljutions of die CU go by die names Portable .NFf 
and Mono. Table 5 describes the mc>st well known distributions 
of the CU. 


.NET Platform Distributions 

Meaning in life 

"t he Mieio.soft .Ntrf Ptalform 

This Ls the commercial C^LI 
im piememalion offered by 
MicrosoO, whidi is geareci 
for u.se l>y the Windows 
family (if oixrating systcjns. 

11 tc MkTosofi Nirr Compiict IramcTA^ork 

A strippal down version ol’ llie 
oflltial MS .Ntrt’ platform tliat 
targets handheld computer 
devices (such as nif^bile 
phont-s and Pix:kei JCs). 

The SUjivd Soiin’e (aj (SSCLI) 

I Ht p:// msd 11.1 iiicn jst >h .a >m/n et/ssdi 

While this implementation of 
tlie CLI has come frtjm 

Micrtjsoll. the code IxLse is 
j)lairorm natural. This 

distribution is more geared 
towards efforts and 

tinkering and is nor intended 
to he a full-fledged 
development platform. 

PiJTtJililf .NI!T 
www.clotfinu .orjj 

Tiiis is an ojien source CLI 
implenienraiion that intends 
to account for all of the 
functionality found in the 
Ltrmjnercial Microsoft .NET 
platform fin addition to Unix- 
.specifAPt.s). 

Mono 

www.go-mon<?-oig 

AntJther <?pen source CU 
implemeniution that also 
inteniU to coi}i[’)ere with the 
commercial Microstdt .NET 
platform (also in addition to 
Unix-specific APIs). 


Tahie % Various distrihutioris qf the Mif Pialform 
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Again, given dial you are reading MacTech (as opfX)sed U> 
Windows Developeivs jOLirnal) i will not spend inutli time at all 
Talking about the official Microsoft .Nirr dLstri)')utioas. Over the 
nexi several arlicics to come, we will come to kntw the SSCLl 
As you will see, the SSCU is a research-fcKused distribution of 
the CLl fliat is a great first step for Macintosh developers 
interested in checking out the .NET platform and the 
programming language. 

While this particular CU distribution dex^s noi provide an 
implementation of GUT ba.sed tcxdkits (sy< h as Winiiow.s Forms 
or ASP.NET), it does tirovide a wealth of technical information 
that will build your .Nl:T muscle. As you examine die SSCLI, you 
will become familiar with .NUl' name.spaces found on any CLl 
dustribudons. 

Later articles will build upon your exploration of the SSCU 
by examining the Portable .NHT and Mono open source projects, 
The,se CLl disirihulions not only provide an implementation of 
ADO.NET, ASP.NET and W'indows Forms, but ship with 
compilers which target a numlier of .NE'l-aware programming 
languages. Unlike (he SSCU, l^tmable .NFT and Mono are 
intended to be a full-blown framework for Veal-world^ .NET 
application development. 


Wrap Up 

Sol I lore you are a: the end of this article and you have yer 
to compile any code and undoubtedly have a number of 
unresolved questions regarding the .NE^r universe, hear not, this 
was l>y design. The point of this drsi article was to lay the 
conceptual groundwork for the articles to come. First you 
learned that the CLl defines a common file format, common 
execution engine and common type system that can be 
implemented on the Mac OS X, tJnix, Linux and Windows 
operating systems. Next you checked out some (but not all) of 
the namespac'es provtdeti by .NhT, followed by an investigation 
of the language- and platlbnii-agnosiic aspects of the 
framework. 

So, until next month, when we install and explore the 
SSCU, allow me to welcome you to ilie .NET plaift)rm! 
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COCOA TIP 


By Clark Jackson, Tacoma Potver 

Printing One Page Reports 


How to accomplish simple program 
controlled printing in Cocoa 

This is another urticie directed al the enterprise. Tlie 
cnicrj^risc hccduse il is there ihai yoit often fittd the need for one 
page reporting of many stripes. Many enterpiise reports have 
data from disparate sonrees srattered over the page but yet are 
n<a complex enough to demand an NSDoeument based 
appikation. Using Interface Builder makes the layout of one 
page reports easy so ail is well-that is, until you need to print 
that repon. Yes, ytjii can idl any NSView lu fmnt itself l>ut that 
doesn't help too much if the views print individually. And, what 
If you w'am to bypass the print dialog and have the output scaled 
and the oneniaiion landscape? This iit> is meant to provide the 
needed inhjrnialion io prinl siiny>le reports w liere ]>age breaking 
is not involved 

Topics 

• Managing view hierarchy 

• Collecting views for printing 

• lienefits of subclassing NSWindowContrcjller 

• Anatomy of frames 

• Moving and residing views 

• Specifying margins, orientation, scaling, paper, and copies 

• Bypassing the prinl panel 

• Mid-code variable declarations 

• Argil me nt-]>:issing timers 

Arranging Views 

ihe window of our sample prognim is presented in 
Figure 1. lE contains information we w'anl to prim and 
information we doni want to print including various Ui 
elements. Its orientation is portrait but the information we 
want printed Ls better suited to landsca[>e and it's loo big to 
fit on one printed page. The Page Setup... command allows 
us to control the scale but when we adjust it to fill the page, 
the defatilt too-wide margias prevent us from doing so. 


Finally, we’d like tlie report to print just after midnight w^lien 
no users are present. 

O Q O (JPiphl^RcjNHl 



Figure L The tvliuhiv caiHaining our report. 

The simple ii|)proach to one [)age printing is to tell the 
window to print itselh [[someReportUI Element window]print:nil]: 
where someReporfUIEIement is any user interface element that is 
in the reyTorl window. The nice thing here is that windows seem 
to scale and orient lhemselve.s automatically to fa a page the best 
way. ibe dnnvback here Is that a window printing itself includes 
its title bar and the window's l>ackgrtJLjnd liorimrital gray 
pinstripes. The pinstripingcan I>e handled permanently or during 
a prinl by the following: 

[ IsomcRcport UTK 1 ement w i nrlow] flc!tBarkg,roiinriColor : 

[NSColor whlLeColar]]; 

L IsomtJtleportUltilerat^nt window] prlnt'iill]; 

[ I someRepo rtUIEi eraent window] setfiack j^routidCo lor: 

[NSColor vindowBackgroutidColorJ J : //resiorcs pinsiripc 


If lie had to do it all over again Clark would choose to Ix’ Ixirn one of the Sons uf Lihcrly. I he fad that the main 13o.su.m organj/.er wa.s Flienezer 
McIntosh and rhat many of ilie group were printers and puhlishers is not last on liini. He can be contacted at cjdckson^Cftyoftacoma.org, 
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Another way u> ciisriy prim a one page report would he 
to lell tlie window to print ils vonivnLs Urls eliminating the 
title bar and gray pinstripe: [[[someReportUlElemenI 
window]contentView]print;nit];. The drawback here is that the 
scaling and orienUUion don't calculate aulomatically and our 
other (objectives remain unmet. 

li should be noted here that if your controller is 
sulKlassct! from an NhWindowConlroller then the print 
statement can he: [[self window]print:nil]: or [[[self window] 
contentViewJprintnfl]; (remember to make the connection in IB 
between the window and the ttmtroller’s "window'' outlet!). 
SuMassing NSWindowController has the added l>cnefii of 
having windowWifICIose: being called on it autojnatically (by 
making the controller the window’s delegate in IB) so that you 
can release your resources when the window is closed. 
Releasing your controller is not an issue for simple a[3j>s that 
<mly have one controller; however, with more complicated 
applications witli many conlrtjllers lliat come and go^ 
windowWillClose: is one way to he notified wlicn your 
window's controller can be released. 

The iiKJSt Ilexihle soluLion to printing view^s together Ls to 
provide a faceless background superview and tell it to print 
itself Including its suhviews. A likely candidate view for this 
puqxxsc is an .NSBox. Start by dragging an NSBox onto our 
window in IB. Make it big enough to cover llie area you want 
prinretl. A custom view in IB would serve as well hut the NSBox 
has the added af>jliLy to draw a border and a title if you should 
w^am them. The inspector in IB doesn't give you the options to 
specify where the title appears but you can do it 
programmatically. Pos.sihle constants are NSNoTitle, 
NSAbovcTop, NSAlTop, NSBelowTop, NSAboveBoiiom, 
NSAtBottom, anci NSBelowBottom. 


Any element you want to print along with your NSBox view 
has to !x" a subview^ of that NSBox view^ You can assign U1 
elements to tx: subviews tjf the NSBox view either in IB or 
programmatically. In order to assign ihetn in IB, drag your 
NSBox view onto the window' first, 'fheii drag the odier 
elenieriLs you want printed/rom thel>cdetiL* on top of the NSBox 
(you will see the NSBox view higiilight). 

If you choose to assign elenient.s programmatically it 
Lakes a little more work because you have to assign a new 
frame location. Let's say you place an NSBsjx view on your 
window after placing an NSTextrield, You send the NSBox 
view t{) the back and put the NSTextFiekl on top. Mbe NSBox 
view doesn’t highlight as you drag NSTcxlField on top of it 
because the NSTextField hasn't come directly off the palette. 
As a result, the NSTextField does not become a subview of 
the NSliox view'. To fix ihi.s sin ml ion in your program you 
would make the NSTextFieid (fNotSubviewTextFicIcl) a 
subview of your NSBox EfBox), in this way: [[fBox 
contentView] addSubviewdNotSubviewTextFleld];. 

Unfortunately, our work is not done because 
fNotSubviewlextField keeps its frame attributes from its 
previous superview (the window) and applies them to the 
new superview (the lliox) most likely causing 
I'NoTSuhviewTextField to disappear by being outside the 
clipping area of fBox. (By the way, variables .starring with T’* 
indicate an instance variable, a holdover from my old 
MacApp days.) Preserve fNotSubviewTextrield’s location (so 
ii i,s not clipped) relative to the window in this way: 

NSRect originalTextFieldFram^s ^ ffNotSnbvifjwTextFtGld framel; 
// gc!t the fcjmc an ihL' window l>tring the superview 

contentView] addSiibvlew: fNoLSubview'rextField]; //move 
the text fictil TO rhe hox view tor priming 
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NSRect newT ext Fie id Frame ^ ori&inaJText Fie Id Frame: //copy 

origin;)] frame into newJaiLT to change origin iioi 

// make alUjwaiice for the NSBox's lx jrdcr 

float xAdJ = 0.0; 

float yAdj = 0.0; 

lf([fBox horderType] '™ WSMneBordcrJ xAdj = yAdj = 1.0: 
else if([fBox bordetType] NSBczclRorder || [fEox 
borderTypeJ ^ NSGroovehorder) xAdj = yAdj ' ^.0; 
boxFrame = [fBox frame]; //get the new Mipmicw's frame 
// culculMie lilt new frame using the differenec Lxiween ilie origimiJ :iml new 
Miperview^ frames 

newTextFieldFt ame.origin. x = originalTextFieldFrame.origin.x 
boxFramo.origin.X - xAdj; 

newTextFleIdFrame.o rIgin,y = o ri g i n aiTextFieldFrame.origin.y 
- boxFrame.origin.y yAdj: 

LfNotSubylewTextField seLFtajde: tiewToxtFiel dFrame] : // give the text 
field its new frame in terms fjf it's new sitpcrvit-w 


The frame method of an NSView returns an NSReci 
structure that defines its position in its superview. For those 
of you new to Cocoa, not all names preceded by refer 
to Objective C objects, some like NSKect, NSSize, NSPoint* 
and NSKange are C structures and ilierefore have elements 
that are accessible via the . syntax, i.e. NS Point center.x = 
IfBox frame].size.width / 2,0; works jusr fine. Figure 2 
ilKistrates the liierarchy. 



The coordinates of the center point of the box 

in terms of its own coordinate system: 
centerx == [fBox frame].size.width/2.0 
center.y - [fBox frame],size,height/2.0 

in terms of the window's coordinate system: 
centerx = [fBox frame].origen,x 

H- [fBox frame].size.width/2.0 
center.y = [fBox trame].origen.y 

+ [fBox frame].si2e,height/2.0 


figure 2, The anatomy of a metis's frame. 


Ntnv UMotSuhviewTextField will print (inspite of its 
name!), having programmatically become a subview of fBox, 
when fBox is told to print. The next problem to resolve ts 
subviews of fBox that you donl want to print. Figure I 
shows a few elements inside of fBox that we don’t want to 
print: fUunBuftorT, fPrinrBiinon, and fProgrcsslndicator. 
Notice wc dtt not include the fAutu check box in this list 
because even though it appears on top of fBox it is not a 
subview of fBox and therefore will not print with fBox. Until 
Panther ships, which adds the ability to hide N.SViews, we 
will have to programmatically move unwanted views outside 
the clipping bounds of fBox before printing—and put them 
back after. 

In tjrder to move our views around conveniently wee’ll 
use a two step process. First, we ll set up the off-view set of 
frames one time wlien our program la undies and second, 
we‘11 provide a method that swaps die frames back and forth. 
We'll need an instance variable array of the U1 element 
frames, fRelocatahlcKramcs. When awakeWilliNil) is called we 
specify the NSRcct’s that are initially llie off-view frames for 
iBtJx's subview'S that we don’t want to print. Since NSReci's 
are nol objects we’ll need to reference them in the array l>y 
index so we enumerate an index as well. The final thing well 
need is an array of the affected U1 elements, 
fRelocatabieObjects. 'llris array wall be used in die method 
that swaps the frames of the objects. 

// make u list of all tlic view:; tliat you want relocak'd, resizol, or liiddai during 
printing 

typt^def enam 
I kRunHutton, 
kPrintButton, 
fProgrefisIndicator. 
kRelocateTextField 
I FlementsToHldeWbl1eprlnting; 

// populnilc flRelocaTabkFrames so dt^signak'd user inkrtatif LlL-mcmts tun be hidden 
tir itlDeatttl during printing 
NSSize myUffViewSlze: 

NSFoint myOffViewLocutlon; 

myOf fViewLocatl cm. x = 170U , 0: // :tn adiiiniry off-view location 
myOffyiewLocation.y = 1700,0: 

fRelocaiablaFrames [kRunButton] .origin = rayOffViewLocatiDn.; // 
rcmeiiiher dUaIcw lucatiou 

fRelncatableFramesfkRunButton],size = [fTextView IxameJ,Size; 
// KTuember original .st/e 

// n'LXtVicw will be diffcanr from the others in that we still want it to prim l>nt at a 
diffcmii location and si/x^ 

myOffViewSize.height = 65.0; 
inyOffVlevSize,width “ 200.0: 
myOffVlevLocation.K = 320.0; 

o>yOffViewLocation,y = [fBox framel,size,height - 
myOffyfcwSizc.height - 20.0: 

fRelota LableFrfienes [kRelocateTextFliSlcl],origin = 
myOffViewLqca tion; 

fReiocatabieFrames[kRelocateTextFleld].aize ^ myOffVlowSlzr^: 

// now iliat tilt new frames iiavc bttn caatcU. makc a hst of affected HI objects 
// so can iterate iwlt them swapping frames as we go 
fRelocatableObjeets = [NSMutablcArray arrayWitbCapacity:5j; 
[fHeloeaLableObJccts retain]; 

[fRelocatabieObjects insertObJect:fRuuButton 
atIndex:kRunButton]; 


32 


Prtn’iing Onj: PagI' Rkfoitis 


MacTech • Oci OBHH 2003 

















During program cxccuiion we need a method that will 
assign the new frames to the relcK'aiable objects at the same time 
remembering the original locations and sizes so that they can be 
restored after printing: 


swaphnuners 

This methiKl ionvi'nkntly hjmtiks the moving :ind resizing of any ckment during 
printing. It reTnembc.‘i>i tht <ild loc;i:ion so th<f pre^Trinting state can be re,st(>red. 


- (LliAction) gwapFrameis r (id) sendar 
I 

int theIndex, theHumberOfObjects: 

theNutnberOfObjects ^ [fRelocatnbleObjects enunt] : 

I 

// Why the brace? arraytTtTsfewFrames Lh deeJnred below as an NSRect only after 
thcNumbt riTfObjcas kis been drtermined. Declaring new variables has to he done 
inside code blocks ix. inside braets, j) 

NSRect a r ray Of MewFcantes LtheNumberOf Objects] : 

// make a copy of the relixatcble frames 

for(theInde;t = 0;tbeInds^x < 

ThPilumbnrOfObjc^etJiiT.hGlndnx-H-} 

( 

artayOfNewFraaies Itheindex] = 
fRelacatablet raiBes [theindex]: 

I 

// pul tlie exjstiiig Ihunes of the relocatable objects into the fRekxaiaNeFrames array, 
fhese frames will be remembered here so that they am be swapped kieic in the hicurc 
forttheTndpx * 0 ;theTndox < 
tboNofflibG rO fOb j net fi; t ho I ndox-H-) 


E 

ERelocaLableFtaitieE Ilholndoxj = t [fR*^loe'atablaObjects 
objectAtIndexTtheIndexJframe] ; 

1 

// now impose the new set of frames on the obietns to he relocatetl/resizixl 

for(tbeTndex - OiTbcIndcx i 
ItioNumberOfOb jects: thelndex++) 

f 

// to rurnovc any vesrige of the tfl etcmciu once ii has been moved 
[[LfRelocatableObjecte objectAtIndex:theIndex] 
superview] setNeedsDisplayInReet: fIfRelocatableObjects 
objnctAtIndex:theTndf»xl framp]] : 

// assign the new Inime 

t [fRel oca tahl i^Objecls objeclALlndex : the Index] 
set Frame: arrQyOrNewFraniea [the Index] ]; 

// make sure it redraws itself after being nioved 
tIfRalocatableObjecte objectAtlndex:thelndexj 
setNeedsDisplay:YES]: 

1 

I 

return; 

1 

The source includes anolher melliod, movcForm, lluit 
demonstrates moving an NSForm into flk>x (making it an fBox 
subview) during printing and back out into the window again 
aflerwards. by modifying the ,slaLcmcnls in these three 
methods, awakeFromNib, sw-apFrames, and moveForni you 
should he able to move, resize, fiide, print, and aftei-wards 
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rcsiorc :iny numhcr of views ihiii you have to meet any single 
page printing requirement. 


Bash: Printing 

Once all our views are in place to print (or noi print) 
we need a method that will direct fl^ox to print. IBoxVs 
output, our report, appears in Figure 3- The mediod in our 
program defaults to uoi using a print dialog, however, that 
ability remains at the user's discretion by using the option 
key. In the default no-user-interaction mode our method 
will s[>ecify page orientation, scale, margins, and number 
of copies. In order to prim bypassing the u.ser we 
instantiate an NSPrinilnfo which contains all the prim 
settings we need including margins and page orientaiion. 
You can choose to have the scaling be automatic to fit the 
page by using setHorizontalFagination:NSFitPagination or 
you can get the NSPrinttnfo's dictionary and set ilic scaling 
directly. With that same dictionaiy you can specify the 
number of copies. Following is the source that 
encapsulates whai you need for priming. 

myPrlntTnfo = ([NSPtlntlnfo allocl 

In1rWitbOlcTlnnary:{SSMutahleDlctionary*)[rNSPrintlTifo 
sliaredPrlntlnfoliliellOT^aryl] : a topy of the shanxI MSPhmlnfo 

provided liy the system 

// ;idju.si dtc tmipns 

[inyPrintlnfo fietOrlentationiNSLandscapeOrientationl: // Lili: 
NSP(>nr.iitOritntat ion 

[inyPr intTnfo aetBortomMargin:30.0] t 
[myPrintlnfo setteftKar^Jn:10.OJ; 

[myPrintInfo setRi^htMargln130.0] ; 

[rayPrlntlnfq setrapMargin:35.0] : 

//You ran sixxify Uw: paper iiatiit liert.jusi itiiike surr your prinitt lias IL for 
unattendtd printing 

// ImyPrinMatb sctP:ipt"rN3nif::'&<^aa:Kal"j; 

// you can Iravc st'aiinf* to he automatic htTC t>r set tlic scalitijj factor as shown below 
// [myPrintInlVi sctHorizontatPitgination:NSFitRigioationl; 

// fmyPrintl tifo sa Vcnic;ilP:iginatj<in:NSFit Paginal bn 1; 

// SCI up tile dictioniiT), it frxsm wur NSPrintInfo 

myFrintlnfoDictionary ^ [kSMutableDictionaryM [inyPrintlnfo 
dictionary]; 

[tnyPrintTnfoDlct ionnry setObjtict: [MJjNutiihet 
numberWIthFloali0.65] forKcyiKSPrlutScalIngFactor]: 

[tnyPrinllBfoUlctlonury aetObJect: [NSNutnber numberWithlntt 1] 
forJCey: KSPrintCopies] s 

// Use either of ihese statemcnis bck>w lo print Uic witKlow or its content respeetivdy 
//m)'PrimOpcration = [NShfinit)pcration pruitl>pemtiotiWiLUVicw:[sdf window | 
pri ntl nfo: myPri ntl n fo]; 

//myPrintOpt-Tation = [NSPrinlOiH.-ration print{>peratitmWithVbw:| |sc:If window) 
content View j pf i nttnfti: my Pri ntlnfo]; 

// nm your print job on fBox 

myPrintOperation * [NSFrintOperation 

pr ititOpe rat icmWlthView: fBox printinf o: myP tint Info]; 

frayPrltitOperation satCanSpawnSeparateTbread:YES 1 ; 

[myPrintOpornTion setShowPanels :N0] : // don t want to see the panel 

[inyFri ntOpnraTion funOperatitiu] ; 

[ttiyPrintinf 0 release] : // it was ailocd so n.'lc3SC' it 


_ 

. . ^ _ ____ IwaidMA M □Aulnfrtfl 

I i nhix tu5vitw 

[ :pf^rMiMTHafKaly j hntft«idlHn ___ __ 

I 1-1 


Figure S- /Box as printed, comtituUng our one jmge refxirt. 


UNAiTliNDHD PlUIMl'lNG 

llie final thing to accomplish is to provide a means to print 
the report unattendeef We accomplish this by using an NSTimer. 
A,s soon as you introduce a timer you need to think about the 
method it will be calling or invoking. If it is nece.ssary to pass 
any parameters to your printing method froju your timer ihen 
you will need to set up a |>rinling inellKxl different from the one 
provided by 113 that is linked to your Print button, 'fhe source 
demonstrates segregating printing functions by using 
prinlUnattBndedWithSca{lng:and^ T!ii.s method has two 
paranieters whicii die timer will [irovide at the time of 
unattended piinting. It is also called by the HI Print button (with 
nil argumenis) when the user .selects to prim without a prim 
panel. Using an NSTimer is shown in die rolk)wing mediod from 
the source: 

CTcatcIVintTimcr 

lliis mctlitid cifuifs :ind relfascit ;i limcT (when ilie lisit lugglcs tlic switch) that 
controls unaUended printinf; at midnight. If you aa' new to NSnimcr an iiUeasliJig 
aspect bi bow argumciiLs arc passed to the meihiKl that h invoked by the timer. Also. 
CTcatirrR and dispo.Hing of NSTinicr's Ls siinwn.This timer is set to fire every 30 
minutes,The printUnarteiidetlWitbSiTalingiandCopies: metluKJ dtres tiie checking to 
vi-rify^ the time and whether or not ilie report lias already printed once for the day. 

- (void) createFrititTiraar: (idl Bender 

[ 

NSInvocation ^prlntUnatteudedlnvocatlon: 

SEL tbeSclector: 

NSMethodSlgnature *aSignature; 

NSKujaber '^JiiyTwo, *jay65T’erccnt : 

// tlit'sc will lx passed as arguments, argnmerits must he objects 
inyTwo = [NSNuniber nunberWithlnt:2] : 
myhSPercent = [NSNumber nuraberWithFioat:0.6SJ: 

If (fPrintTiineri // timer alrt;ady exists so^ dbpOM: of it 

( 

iKUPrinlTiiner IsValld]) 

I 

irPriritTiiner invalidate] : 

[fPrintTimer release] : 
fPrintTimer = nil: 

I 

else 

I 

NSLogC^"should never end up here where timer exists 
and ia invalid"): 
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1 

f 

elsje // LiiiKT diK‘Mii'1 cxil.tTXiilL- liiiier 

// induilt Urn below if you warn tlic mctlKKl talkd as stxm as tJit liuicr us 
turned tm, tinkers fire first time AFTEK period has passed 

// [self priml [nattendedWithScalirtgimy^^Pervenl artdCopiesrmyTwol; 
thp-Selector ^ finplectortprintrinattendpciWithScaling! 
andCopiea:); 

aSignuturp = iMyWiadowController 
InstanceMethodSignatureForSelector:theSelectorJ ; 

printUnattendedInvocation [NSInvocatlon 
invoc atlDityithMethodSigaatura; aSignatora | ; 

fprinTDnatTandpdlnvocH^TEon .'iptShlactoriTlTRSalactorl; 
[prlntUnatteridGdlnvocHtion setT^rget:self 1 : 
[prlnLUnaLLondadlnvacaiioa sat Arguraont :itity65Parcant 
a L hid ox: 2] T // tmlcx I is where arguments in the merhtid kgin, mtv ampersiind 
[printUnattendedInvocation setArguioenti&myTwo atlndex:3]: 
fPrintTiraer ^ [[NSTitner 
schsduledTitnerWithTinielnterval: 60’30 

invooatJon ;printllnatteBdedfnvocation repeats; YES] retaini; 
//6di^0 is timer repeat period, CseeondVniinute)*minutes 
I 


Conclusion 

We have resolved many of the .single page report pi in ting 
issues. For example, we have answered how to colleel views for 
printing making subviews Ixjth in IB and prognitnniatically. We 
have show how to reloatte and resize views in a clean way for 
priming including the ability to exclude views from output. We 


have shewn how u> bypa.s,s die prim panel specifying number of 
copies, t)rien£alion. puj>ei name, scaling, and tiiaigins. Finally, 
we constructed a simple argunient-passsing timer that wall run 
your prim jobs at any ,specified lime. For multi-page printing jobs 
there is always NSDocument. 
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Authoring and Deploying Help in a 
Multi-Platform World 

iNTRODDCnON 

Fveiy significant desktop applicaticsn recjuires an 
imegratcd Itolp systeiiL Most successful applications will 
ultimately am on Mac OS X, Windows, and possibly other 
platforms like Mac OS 9, and Linux. Product developmenr is 
seldom a one-time event, but rattier an ongoing process of 
enhancement, evolution, and bug fixing. Developers need a 
strategy for authoring, deploying, and maintaining help 
systems in a multiple platform world. 

Some IDL (Intenictive Development Environment) vendors 
have recognized the need to develop for multiple platforms. 
With RealBasic', from Real Software, yoti can create your 
application once with a bit of conditional logic to handle 
platform-specific issues, llien generate I'luilds targeted for Mac 
OS X, Mac OS 9 and/or Windows. Likewise, lk)rland"s Delphi is 
a fxtpiilar IDE for Windows tliat has a source code compatible 
cousin on Linux named Kylix. These tools enable your 
application to take advantage of the unique features, and user 
inteiface, of each operating system, yet can subsUimially reduce 
the cost of multi-platform development. 

MacHelj^ is the H'lMl based help format developed by 
Apple for Macintosh software. Most Windows applications use 
Microsoft's HTML Help or ils predecessor, Winlielp. Many help 
authoring tools have l>een developed arcnind these formats. 
TlnforlunaLely, when Apple and Microsoft created their platform 
specific help fonnats, easy poning to competing platforms was 
not a high priority, 

Linux started a.s a variant of Unix, with a command line 
interlace, but in recent years imj^rovements to the KDE and 
GNOME desktop en^aronments have made Macintosh and 
Windows users feel itghr at home. Help information for Linux 
has traditicHially been delivered as Read Me files, MAN pages, or 
ID ML files. These apj^noaches are awkward and inadequate for 
new GUI programs arriving on Linux as it moves to the desktop 
in more organizations. 

Help authoring approaches for Macintosh typically rely 
on editing a collection of topic files using IflML tags tor 


formatting. Lots of time is spent on formatting pages, 
organizing topics and man^iging and maintaining hundreds of 
links between topics. Given enoogfi time and effort, you'll 
end up with a nice help system for your Mac OS X 
application, hut then must substantially rework it when 
porting lo Windows or Linux. 

QuickHelp is a new authoring tool ba.sed on the idea of 
writing help once, then deploying it to virtually any platform 
including Mac OS 9, Mac OS X, Windows 95 to XP and Linux 
KDE or GNOME. This article provides an overview of 
QuickHelp, shows how to develop a help system* add context 
sensitive appliaition links to help topics, and then deploy your 
hel[> system to Macintosh, Windows, and Linux computers. 







Qaicklkip Vietpcron Mac OSX 

QiicicHjelp Ovekvtrw 

Most help systems, including MacHelpj store topic's as a 
folder of H'fML [:)agcs that reference other files containing images 
and indexes. Microsoft's HTML Help lets you compile your help 
system to a compressed file, making it easier to deploy. When 
users activate help for an apj^lic^ation, a separate viewer 
executable allows them to navigate and view topics. Hie help 
format and Viewer executable are tied to a specific plarform. 
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QuickHelp stores the topic text, im^tges and organiTiitional 
information for your help system in a platform neoiral XML fiJc. 
XML (extensible Markup latngiiage) is an industry standard 
formal for su>ring and exclianging information. It descril^es 
information as tagged data in a text file that s human readable, 
self-documenting, ami widely supported ihroughout the 
soft^’arc industry by editing and parsing tools. 

Like any help system, topics and navigational features are 
presented via a Viewer There are four QiiickHelp Viewers, 
one each for Mac OS 9, Mac OS X, Windows and Linux. 'I'he 
Windows Viewer nins on any Windows operating system 
from 9S through XR I'he Linux Viewer runs on all popular 
Linux distributions including Mandrake, Red Hat and Suse, 
and supports the leading desktop environments KDh and 
GNOME. Qiuckilelp Viewers for MacOS X and Windows can 
be downloaded from shareware sites. QuickHcTp developers 
can distribute the Viewer executable royalty-free along with 
their help file. 

Regardless of the tools you use, help autiioring can be 
characterized as an iterative Organize-Edit-Buiki-lejit 
process. Most authoring tools give you a project environ meni 
where you can add and organize HTML files and images. 
Some totals let you edit tt>pics directly while others rec|uire 
separate text or HTML editors. Creating topics with colored 
text, formatted images, and hypertext links can be a labor- 
intensive process when using HTML tags. Most tools use a 
build process lhat links everything together before you can 
view and test the finished help system. Depending on the 
authoring tool, there may be features for locating missing 
links and image references. 

The Builder edition of QuickHelp tightly integrates the 
Organize-Edit-Buiid-Test process into a single tabbed 
window'. The Builder looks just like the Viewer, with the 
addition of the Edit and General panels for organizing, 
editing, and managing your help file. From the Edit panel, 
you can create, edit, and delete topics and organize them in 
the Contents tree. Your help information is stored directly in 
the XML hie. When youTe ready to view ihe finished help, 
just click the Contents or Index lab. QuickHelp eliminates the 
build process, and integrates the Viewers feaaires directly 
into the Builder for quick resting. By integrating tlie entire 
authoring proce.ss into one tabbed window, the learning 
curve for QuickHelp us reduced to about 10 minutes, and 
developer productivity is improved. 

Creating Topics 

The Edit panel is used to create topics in a help file. The 
left side of the panel ha.s a table of contents that shows the 
title, indentation, and position of each topic. When a topic is 
selected, its information is shown in the fields on the right sitle 
of the Edit panel. There are fields to title the topic, assign 
conditions that affect its visibility, write its tody text, identify 
index words that appear in the user’s index, and as,sign a 
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unique integer or string to identify the topic for an 
appMcariorVs context sensitive help. 


the tible of contents. Lise the anow buttons to change the 
]x>sition or indeniation of a selecled lopic. 
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Tlie New Ixiiton is used to create a topic in the table of 
contents below tire selected lopic. The Delete biition deletes llie 
selected topic. 'I'he Move button is used to move a single topic 
or group of topics to a rlifferent locution or indeniation within 


Formatting Topics aod Adding Images 

The Insert Tag button, at the top right of the Body fiekh 
is used to in sen a tag into the text of a topic for applying text 
.styles, adding links to other topics^ or inserting forniatted 
images. Alliiough it is possible to edit formatting tugs directly 
in the Body field, it is easier to just click the Insert Tag button, 
and choose a popup menu command. For image tags, a 
dialtJg is prcsenied to selec t an image and define caption text 
and formatting. 
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Linking Topics 

HyjKMicxi links conneer highlighted words to other topics in 
the same help file, or in a different help file. Lcx:al and global 
link tables relate matching words in a topic hcidy to the target 
topic. QuickHclp auiomates the proce.ss of creating and 
maintaining links wlicn repositioning or renaming topics. To 
create a link, jusi select .some text in the lopic, click tlie insert 
Tag Ixiiion, and pick the target of that link from the Link 
Definition dialog. 


Link Definition 


Matching Wordi: 
Topic Title: 
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Link Selecled 7exl from Otte Topic to Anatber Topic 

Like HTML approaches, topics in Quickllelp are CTeated 
with text and IbnmLiing lags. Topic editing in Quick Help tmdes 
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fiomt! of the ;md in<xsi of llic complexity of cTcating 

HTML pages, for a simpler, more productive environment. The 
end result Ls professional looking topics that are consistently 
formatted and viewable on any plaifomi. 

Making Topics Conditional 

Regardless of how similar your appIkraLion is on each 
plaifonn, there's bound to be a few platform specific 
features. You could create your help file for, say, the 
Macintosh platform, and then copy that file and modify ii a 
bit to create a Windows version. While that's a lot less work 
than learning to use different help tools and rewriting the 
help system for each platform, ytm'll still have differeni help 
files to main lain for each new release of your application. 
Furllierinore, larger applications are sometimes offered in 
several different editions on each platform, so you may want 
a customized help system for each edition. Using condilU)rial 
topics, QuickHclp makes it easy to support multiple 
platforms and multiple editions of your application with a 
single help file. 

For example, lets assume you have an appliaition that's 
available in IX-mo, StancLmJ and Professional editions, and it 
nins on Mac OS 9, Mac OS X, Window^s, and Linux. During 
runtime, you'll probably want to present 12 slightly diri'erent 
flavors of your help system originating from one QuickHelp file. 

Help topics can he conditional, and text or images within 
a topic can be conditional. When viewed in the Contents or 
Index panel of the QuickHelp Viewer, those topics, or 
portions of a topic, will be hidden or visible based on the 
current conditions. 

To conditionally include a topic, define its condition in the 
Condition field of the Kdit panel. ‘Lhe conditional expression 
contains names, and Lkxjlean opcniiions that evaluate TRUE t>r 
FALSE during runtime. Use llie Conditionals dialog, accessible 
from the General tab, to define names antl/or set the lairrent 
state of th(>se names. In this example, we'll use die names 
Demo, Standard, atid ProfessiotiaL 

Within the condition you can use AND, OR, XOR, NO^T, ( or 
) to create the expression. Here is an example that conditionally 
includes the \opk m just the Professional edition wlien running 
on die Mac OS X platform: 

Profeasiarml AND MulOSX 

If the State checkfxix is set for the Professional name in the 
Conditionals dialog, and this help file is currently running on 
Mac OS X, then the topic Is visible, otherwise it is hidden. 

t opics can lx* nested in a tree structure. If a topic is hidden, 
all topics nested under it are also Iiidden. It isn't necessary to 
repeat the conditiotis of any parent topic of a subtree, but it is 
okay to do so if it helps you remember exiKOly what conditions 
apply to each topic. QuickHelp automatically removes 
hyperlinks from the rest of your help system to those hidden 
topics during runtime. 
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To conditionnlly include a porticjii of text within the body 
of 'A topic, cncrlose if wiilMn ^^ifcondition, and #enclcondition as 
si low n IjcIow. 

condition Professional AND HacOSX 
You're running the Professional edition on Mac OS X 
ifendeondltlon 


Locating Topics 

Tlic Index Words field of the Edit panel is used lo 
automaiiailly build an alphabetica! index of ke>'words tliat the 
help author wants lo associate with each topic. During nmtime, 
the help user can locate, and navigate Lo Kjpics from the 
Contents panel, or the index panel by clicking hyperlinks within 
a topic, or by clicking on the Back and Eorwartl buttons to step 
through recent viewing history. 

The entire help system is usually deployed as a single XML 
file. For really large projects with different subject areas, you can 
chain separate help files nigeiher with hypertext links. 

'rhe helf) user can use the Find Topics dialog to locale help 
topics that contain specific words in its body. 

Each Topic has an ID field that contains a unk|ue number, 
or string, tliai can l)e used lo identify that Ltipic from the 
application when implementing context sensitive help. For 
examf>le, if [he user iX)siiic>ns the mouse over a menu command, 
window, or dialog wit] iin your application, you can run the 
Quick]leip Viewer by having the user i>iess FI, triggering the 
Viewer to present the related help topic. Context sensitive help 
is discu.ssed below. 

Working with Help Files 

The General panel is used to read and write help files, edit 
global link definitions, and set preferences. There are 
command buttons to create, open, save, and verify help files. 
Help topics can Ire listed to text, or imponed from text. 'I’he 
help develot)er can assign a defatiii font whic h can later be 
changed by the help user. 

CONTEXl SEN,Sn iVF. HeIF 

You can double-click the Quickllelp executable or a help 
file to launch Quickllelp. More often, a user wants to view a 
help topic related to a spec ific feature In the appikaiion. 

Once the help file has been developed and tested on the 
various platforms, and accounts for the slight user interface 
and feature dilTerences, ycniTe ready to add context sensitive 
links from the application. In Windows, users expect lu press 
FI W'hen the cursor is positioned over a menu command, 
window, or dialog ttj see the related help topic. Likewi.se, you 
can support FI, ov any approach of your choosing, for each 
platform using simple communication commands between 
your application and QuickHelp, These commands send the 
ID of a topic lo Quickllelp^ ba.sed on the user's context within 
the application. 


Windows programs talk itj QuickHelp using a couple of 
COM (Component Object Model) methods. COM Ls a Microsoft 
technology for sending data from one application to another 
ihaFs supported by vinually every Windows programming 
language. Macintosh applications talk to QuickHelp uiili^ing a 
few different Apple Events. A Linux appEcation would use a 
pipe for communication. 

In each case, die application w^ould need some code 
inserted to allow it to recognize that the Fi key was preased, and 
ensure the appropriate topic ID was sent to QuickHelp using a 
COM method, AppleEvent, or Linux pifx:. QuickHelp provides a 
description of these commands, and a snipiM of code diat can 
be customized lor the language, or platform of choice. 

QuickHelp also comes with a ready-to-use Real Basic 
QuickllelpCJoniroller class, a Delphi TQuickHelpConiroller class, 
anti a Kylix “lUelpVlewer class. To complete a multi-platform 
lielp authoring project, use these .source cxxle classes, or create 
something similar, in your own application code. Finally, add the 
appropriate topic IDs to each menu command, window, and 
dialt>g, then lest Lo ensure that the appropriate topics get 
displayed in QuickHclp, 

CONCLliSION 

To create a gotid help .system, a developer needs to 
understand what a help system is, and what it is not. The 
purpose of a help system is to quickly inform the user, not 
enteriain them with flashy pit'tiires, or moving video. Pictures 
can add a professional touch wlien used lo guide and 
reinforce understanding, but don't waste screen space vvith 
snapshots ihai are quickly outdated when new features are 
added Lo your apfilication. 

Help topics should be shorU cohesive, and to the point. 
Don't make users scroll through long topics to find the 
information they want, or expect them to read your help 
information page by page like a book. Users go lo a help 
system wlien ihey have a .specific questinn or problem, so 
most topics should he very task odenlecL Listen to the 
questions users ask when learning to use your software, and 
make sure there's a topic that addre.sses each one, a 
descriptive title that clearly identifies it, and keywords thal 
make it easy to locate. 

If you're developing an application thal w'ill forever run on 
only one platform, you have many programming language.s, 
IDEs, and help authoritig tools to choo.se from. However, if your 
application resides in a multi-platform world, then you'll need to 
carefully weigh the alternatives for developing and maintaining 
your code and helfi systein. 

In addition to simplifying the authoring process, QuickHelp 
makes it ea.sy to create and maintain a single help file that can 
be deployed on dilTercnt operating systems, suppcais muliiple 
product editions, and woi ks for applications written in virtually 
any programming language. It provides a consistent, 
professional help environment for Ixah users and developers. 
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REVIEWS 


Hy Ron Davis 

Book Review: PHP and MySQL 
Web Development 


It usetl to Ix' yoii weru [in HTML “programmer" if you 
undersKKxl whal <B> was. I’ve never really thought there was 
any sucli tiling as a irrML "programmer" HTML is a nmrk-up 
language. It's data, not insinitlions. I’m not going to get into my 
personal feelings on seripting verses programming, hut IVe done 
a bit of (jne and a lot of tlie latter The cLiy c'ame wlicn my 
personal website needed to )x' able to generate content on the 
Hy and I w-ent looking for a language lo imke it do so. 

At first wlial I wanted was C/C++ bm that rt^dly isn't wliat 
yt>u want to do weh work in, liememl>tT you are mostly 
manipulating text, whit h C/C++ isn’t really all that gcKxl at. Also 
you are generally working with a machine you ain't compile on, 
Yc)U can u[:)load files though, and those files can Ix.^ executed, so 
you need a scripting language. 

Perl is ihc language everyone asscKiates w'ith IINIX, hiii 
after attempting to remove my cerelxfllum through my eye 
scKkels during early Perl ses.sions 1 went kxiking for another 
language to write in. Tlial's when 1 found PI iP, I lere was a C like 
scripting language made to generate w'eh pages - one thal 
integrated with databases, for even more interesting fKKssibilities, 

There are a lot of gotxl online tutorials on the web for PHP. 
It is a very popular language. This is partially l>ecau.se it is free 
and t^anially liecause it doesn’t incktee suicidal tendencies when 
you try to ccxle in it. 

While there is no real link between PHP and MySQL they 
always seem lo go together litis is mainly bec:ausc they are lx>lh 
free and offered as part of Linux, the dominant philfonn for web 
hosting companies. So everyone with a weh site gets PHP and 
MySQL for free. 

When it a>mes lime to get serious uIkjuI learning to use 
these two technologies, you sliould pick up the Ixxtk FllPmid 
MySQl IPhh DetK^hfmietit by Luke Welling and l-mra Thomson, 
It is Ixtth a great intrcKluction and reference for PfIP. 

Perst^nally I like Ixxiks that teach you l^y doing. 1 want 
examples that will provide real world use. bven when a lxx>k docs 
an cx:iin[>le a clta|>[er, 1 wkl often changer ilic cxainple to 
sometiiing i need as 1 read. FHP and MySQL Weh Develc^mml 


tkx:fs this well. After the required inlnxliatory chapter, each c hapter 
introduces a new concept with a relevant example. In the end you 
have a c'omplete web site with lots of different functioruility, 

'lb use the Ixxik you are going lo have install PHP and 
MySQL. If you are using a non-sender version of MacOS X you 
will have to install MySQL. There is downloadable package to do 
this with instructions at Marc Liyanage'.s site: 

hUp://wvvvv.enTropv.ch/softwar€/macosx/mys(il/ 

If you want to am PI IP ctxJe on your kx^al machine using ilic 
built in Apache server, you will need to do .some configuration, 
Apple provides some instiiuiions on how to Jo this. 

http://developer.apple.com/internet/macosx/php.html 

Once this is done you sliould liave no trouble doing any of 
the examples in the txK)k. I found no platform-specific problems 
while using the Ixiok. 

'I'he first pari of the lK)ok leaches you t!ie basics of PHP, 
including how you put PHP code iaside your HTML file. It gcx,\s 
on to di,scuss the various features of the kmguage includeing 
manipulating .strings with regular expres,sions, reading and 
wTiting files, and arrays. Alter you get a basic understanding of 
PHP, it switches to talking about MySQL, 

'Hits first section on MySQL deals only with designing an<l 
creating dalahascs. You work on the command line w'ith MySQL. 

After you have learned to use MySQL, you’ll learn how to 
tiilk to MySQL, with PHP There are two chapters in the MySQL 
section showing basic and advanced inteiuction. In reality talking 
to oilier databases is accomplished almost exacily tlie Siinie way. 
I had a site 1 built on my IcKril mac'fiine using MySQL and then 
moved to a server anti used ii witli MS5QL by changing the prefix 
on the atlling routines. 

Part three of the lxx>k is the meat of learning to use these 
technologies. The am hors .ste p you through a complete e- 
comerce .system built with PHP and MySQL. By the time yt>u 


Ron Davis Ls a long lime Madnio,sh Software Engineer, having worked for comjxinies like Apple and Meirowerks on a variery <>f pnxlucts from 
development tools to anti-virus software. His day pb is working for Alsoft, and his evening job is U.A.D. Productions, makers of Suck It Down 
and I'inderKye. 
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^el to this point in the book you understand the language 
ami MySQl, enough you can just start pulling live sections of 
this [program you need out and use them. If you skip around 
you will occasionally Itave lo go back to a previous chapter 
to figure out how' the database is set tip or what some 
varial>les mean. But if you need a user system, refer to 
chapter 24 ""Bu tiding User Authorization and 
Personalizntton.** Shopping can? Chapter 25. Content 
man age mem system? Chapter 27. 

A()pendL\ A on installing PUP and MySQL is largely useless 
to the Mac user 4’he index is good, kiting you use the hook as 
a general PUP/SQL reference. When you want iniav tiepih you 
can check t>ut the PIW manual online at: 



Icons to go! 








http://www.php.net/docs.php 

Appendix B also gives an extensive list of w^eb resources. 

This lxx)k sits on iny IxKjkshelf with little post it notes 
sticking out at relevant pages, 'llie only real coiU[]lamL 1 have 
alx)Lii tite Ixxik is its size with over HfK) pages. But it does cover 
a k)t of stuff. Also since it is exauiple based, it i.s somewhat Iiard 
to find a specific PHP function. I have little Ixxtkniurks fcjr the 
date command and the SQI. Alter table command. 

If you are looking for a gtxxJ lxK)k cover all of the things 
alK>ut PMP and MySQL you need to do most comtnon web tasks, 
this lxH)k is it. 


Now dipvpkipprs can pi^rchase compete cdtectcns 
of professional^ desigsTed ioxts at an affordable 
price from Uie premiGf source for custom designed 
icons in tlie irxluslry See some of the wcxk we have 
done for Apple, MiomaiL Alackiin, Intuit, Palm and 
many Ofthers at wvwviconfacloiydesign.conT 



Each stock icon coitectrori ror^tanis SOtixlfviti^jal 
icons m Uxee pocet a 2 es - 32x32.24x24 and 16« 16. 
Cotteclftsns are nrjique m styfe and am provided in 
an an^ of formats intlurJw'ig iransparet it TfFs, 

GIF. PNG. .icns, and Windows formal x o'v 
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By Kevin Hemenway, ihiqimtchable Excellence 

Enabling CGI Scripts,The Second 


You’ve enabled CGI, but how do you 
know it’s good? 

In the Iasi is,sut\ we leamciJ aboul CGI scTipus: whai they 
are, what tliey on do, how they're already enabled witliin 
Apache, and how^ to tweak that eonFi|»uration to be more U1<I 
friendly, What we didn't do is teach you anything for the future: 
at most, wc brought a wide-eyed wonderd>oy to a patch of 
poison ivy, and hacked away slowly. Will he rub it on his 
skinned knee? Pin it \n little Susie’s dress as a token of his 
affection? Roll around in it like catnip? Where is (he iufjredfmr 
necessat^^ for every cbild*s stmnval? 

Insert transitional onediner here! 


interj;>reter (w^here it means something we’ll cover a bit later). 

Another similar difference l>etween our two scripts is the 
priming of something called a ContmHype (listing 1), wiiieh 
tell the requesting user-agent (your visitor's browser) what sort 
of data it's about to receive (an image to render, text to display, 
XML to parse, etc.), The Content-type will never actually Ix: 
shown in your final output—it's hidden pixie dust for the 
browser's benefit only (if you’re curious, Mozilla allow^s you to 
view the Contem-type by getting the ^Page Info'' of the current 
URL). WiihoLii tills crucial bit of contextual magic (and the two 
required newlines), Apache will fail your CGI scripts w'ith an 
**InternaI Server Error". This error is never a satisfying 
explanalion—ytmll need to check Apache's 

/var/log/httpd/error log for ihe exact reasoning. 


Dissection—S iMnARiriES 

Before we can unclersfand, be aware, and watch for the 
secTiriiy i-amificaiions of running CGI scripts from unknown and 
iintnisted ihird parties, we need to see how ihey're axled, how 
p<K)rly written ones can ruin our mornings, and how^ to kx)k for 
some semblance of quality. The quickest way to get a genend 
feel is with the tw{> s;iniple scripts already installed witfi Apache: 
/Library/WebServer/CGI-ExecLftables/piintenv and 

/Ubrary/WebSetver/CGl*Execui^3les/priii^^ if you 

looked at their stxirce ctxJe last month, you may have noticed 
they're written in two different languages. 

The smaller of the two scripts, test-cgi, starts with #!/biiVsh, 
whereas printenv instead uses #!Alsr/birVpefl -T. These lines, 
specifically the #1 prefix, are often oiled the ‘"sliebang", and tell 
us which interpreter wall execoLc the programming instructions 
that follow. The inierpreLer located at A)in/sh, rarely seen in 
production CGI, indicates that the rest of the c<ide is written in 
the shell scripting language. Any CGI script you deploy will need 
to have sr>me sort of sheliang—-whether it's /bin/sh, /usr/bin/peil. 
/usr/bin/jaython or something else entirely, it's abst>lutely 
ret|uired. Not only is it necessary, it also Iuls to Ik* accurate: if 
your only Perl is /sw/bin^seri, then the shebang should point 
there instead. Shebangs can also contain command line 
arguments: in printenv, -T is passed direc:lly to tfie Aisrybin/perl 


Listing 1; Priniing the Content-type in .Shell and Perl 

J’roin ihe sampir OH wripi.^ printenv :ind test-cgi 


ctmtcni type display fmm iesi-C|d 
9 nme that cebu spits im a tirwline, 

^ 2 Cibo’s for itk- 2 a-qutnxi m'wUnes, 
echo Content-type: text/plaln 
ocho 

and the similar entry from printenv 
print "Content-type: tcKt^htmlVTiVti" : 


Hie values of our Content-types (texty^larn and textflilinl i 
didn’t just api>ear out of thin air—they're M/ME types, and mast 
any file you've ever worked with has one. You atn find a large 
listing of MIMK types, (rased on their common file extensions, l)y 
pcnising the /etcAittpd/mimatypes file. Ftjr example, the 
matching MIME types for Jl^EG, XHTML, Qutektime, and 
Microsoft Word files are: 


Image*/ j peg 

applicflllon/xhtniH^ail 
video/ qiii cki ime 
appXlcation/msvord 


jpeg jpg JP^' 
xhtml xbt 
qt inov 
doc 


If you can't find the matching MIME type for the cbta you're 
interested in serviiig teichcT lx.*cause it’s not in the mime.types 


Kevin Hemenway, coauthor of Mac OS X Hacks and Sfiidentig Hacks, is bcucr known :is Morbus Iff, the creator of disobeycorn, wludi bill-s itself as 
"content for the distontented/ Publisher and developer of more home ctK>king than you could ever imagine (like the popular open-sourced aggregator 
AmphetaUesk, the iKst-kepi gaming secret fiamegrene.com, die ever ignoralile Nonsense Network), he’s twirling liis hair and trying noi to cheerlcad, 
Contan him at morbus@disobev.com. 
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file or Ci<x>gle ha,s spiiraed your search request), you can use the 
''some s^jii of dam” MIME type of applicatiorVoctet'Stream. This 
has already been explicitly a.ssigticd to a number of files, 
including Apple disk images: 

application/octet-streaai dms Iha Izh gx& class so dll dmg 


Dissi-cnoN — 'Wm Thi-: Perl Script Is Arguably Stronger 

All CGI scripts, regardless of wliat dicyTe prognimmed in, 
can lie run from the command line—whether they actually do 
anything useful is a case-by-case basis. ITiis Ls a surprisingly 
useful bit of information: since troublesho(>Ling and tiebiigging 
happens best when imfrilled t>y ctrmpliaition, removing Apache 
frojn the process can prove helpful. Running your CGI scripts on 
the comnmnd line can preemptively weed out problems like 
mi.ssing C/>ntent-type*s, file permission errors, invalid syntax 
problems, ntiiising language extensions, and so foith. 

E5oth the test-cgi and printenv .scripts nm ^successfully" at 
the command line, although only the first gives any useful 
output (Figure II Compare this to the regular browser-l>ased 
output we demonstrated in tlie last MucTi^ch (or simply re-access 
http:y/t27.0.{3.1/cgi’bin/test-cgi). The first line is tlial dastardly 
Conleni-type and, as mentioned before, Is normaUy processed 
by the browser and removexJ frtmi tlie final display. Since weTe 
running the script without the l:>enefit of a wel) server or 
browser^ liie Cf>ntent-rype is viewable without extra el'fort. Tills 
l’)ecomes a liandy barometer: if you run your CGI scri]:>t frerm the 
command line and lhere*s no ConlmHylk*, it'll never nm 
correctly under Apache. 


Termifiat — basK ^ basb tttypl) — 68x27 


m\ 

MThuwidisobey^/l.ibrqiir/VeiiQeirYBr^ > 

Content-tvpe; text/piatn j 

C&1/1.8 test script report: | 

orge U 0* orgtf Is , 

^l(VEfi_S0rT¥Al9jE » ! 

5EfiV£R_NW« a ' 



F'lgiif'e 1: The slightly undefined t^-egi, when 
mn in the Terminal 
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But wait.., there's no Content-type if we try la run printenv 
(in hci, there's norhin^ ui all), ,so w-hy dtX!S it wx>rk when we 
access it by URL (htlp://127.0.0.l/cgt-bm/printenvj? In acnmlity, this 
is one of tile “sti’engths” of the Perl version. If you check the 
source code, the next line after oor reejuired sliebang (ignoring 
com men Ls ) is: 

exit unless (SENVUREQUEST_KETHODM eq *»GET’'h 

ThLs Lerniinates the script unle.ss it was invoked via a GET 
request. Generically speaking, unless it is a POST, every request 
a web l)rt>wser makes is a GET will) or wiilioiit key/vaiue pairs, 
Sinev tile sliell isn’t a web browser, no GET is issued and tlie 
script lemiinates. If we wanted to get fancy, we could fake the 
required method by njnning setenv REQUEST^METHOD GET 
&& yprintenv (if you’re using the Isch shell; 
REQUEST_METHOD=GET T^rintenv if you prefer bashr .^,s a 
re,sult, we get a 'lerminal full of HTML listing the environment 
variables. We can redirc'cl this mass of IFl’Ml to a file by adding 
> outputhtml to t)ur previous command line; Figure 2 sliows 
the generated file. 



T*#mw«a - bull - toiih (rtvplj - 

>,|£qMES1.t«ltOCM£T 
CO FrttfiMi E;wiii3iiin«nt 


Ciinumi-Eype; icixiftiinit 



cm Ituttf KS linviriwitKKt 


j[. /printenv 


XSa.C^ALpG FU-KS[j7»«74iLc7^I7c«Aioi^ 


sHi-vi.||r 


PER L^Ltan/ w/ Uita/pcris 


t^D| |/Ll"^r«f y/tfaliscrvvr /CCI -gir^Cilteblae 


( VS WSH]Pil^ 


MANPATH|[/m/etiere*'MPi/uar^*heje/p4ni/'u #t ffg Al/tta ft v jj 


GDK^USC XiT|i 

TERMJ^H^RAMlti^ypfe Tn^anei 




THRM PRtXillA VERSION 


OLDPWDn /l/ura /norfau n 


SOML^CAT a LiOCC ni,tiS|/eif/etc/ ftfBl /cAtAlc^ 


REOUESTlMETHoij^ 


[L-CF.I JSER TEX T ENCdDlNCfot i n 1 9^ 


.XEKMIvLuslI 



figure 2: Shell onlpiit of our tricked prinierw scrip! 

Figure 2 also gives us another reason why the l^ed script is 
stronger: it doesn'i pretend u> know what the environment is 
going lo l(K)k like, test-cgi, hard-coded to display the values of 
known variables (SERVER„SOFTWARE, SERVER_NAME, 
GATEWAYJNTERFACE, etcj, shows nodhng but undefined 
values when run from liie Tenninal (Figure 1), wliere those 
sixrcific entries don't normally exist. 


Three Ways Peri. CGI Scjufi's Can Be Improved 
The bulk of the code within the printenv script caters to 
creating a pretty HTML page, .something ooi important to the 
true purpo.se of generating a list of the current eavironmeni. 

To make our upcoming improvements more clearly, we'll 
base our changes on the Perl script shown in Listing 2, 
which does the c^xact same thing as printenv, only withom i 
the HTML- For all intents and purposes, this is a w'orking CGI | 
script: it’s got the shebang pointing to the correct Perl 
interjireter, and it prints a plain-text Content Type liefore any 
other data. 

Note that even though we're talking specifically about 
CGI scripts, the following improvements can, and should, lie 
made in most any Perl script, cisfK'dally those to lie used in 
prtxlucrion environments. Security should never he a feature. 

Listing 2: Printing the covirannient more simply 

Our l%L*vtr.p| script ctmid ilsc sonic inipnjvcnn-nts 

fl! /usr/hiti/perl 

print ‘’Content-type: text/plain\n\n'’: 

toreach $vat (koys %ENV) I 

print r = $ESV t $va r1\; 

1 


Save this file as base,pl and run it fnim die t'ommand line; 
my output is in Figure 3^ None of (nir Ltpctmiing iinfirtivements 
will change this display and, as you can see liy comparing it to 
Mgure 2, its idenlicai save for the lo.ss of IHML (and liie 
differc’nces l>ctweeji Safari and the 'lerminal’s interpretation of 
TERMCAPl 


Term I flat — bash — bash (ttypU — 69x28 _i 

I base.pt Si 

) Content^type; text/p to t n ^ 

_ - /usr/bin/pert | 

Xtl^CATALOG_FltXS * /sv/etc/xwt/cototog | 

TERHCAP » 

SHLVl . 1 

F€I?IJLIB * /w/lib/pert5 
PND - /^sers/aDrbus/OesXtop 
= ssh 

HAWATW - /^/3tx3T«/flori;AJ3r/«hare/B(»^^/U3r/ locat/wvi;Atsr^lRti/ii(in ' 

GOK.USE^XFT = 1 

TERH.F^^OGRAri . Apple.Tetminoi 

USER o JDortXis 

HDHE ■ /UsarG/norbus 

TERrt_PROGRAM_^EJ^IQN . Si 

OLPPND s Ateers/%orbLia 

SCHL^CATALOG^FiLES - /sw/otc/sgaL/catalog 

__CF_IIS£R_TEXT_EKCOOTNG - 8!£lF5;e:& 

TERM - vtise 

CVS_Rf)0T > ^:ext:BorbLB4cys.aiiphetQdesk.sf ,nst,:/cvsraot/c]BpMeto(lGsk 
PATH > /sv/blru/sw/Gbln:/bm;/sPin:/Osr/bin:Atsr/sbin:Aisr/Loc»l/bln: 
Anr/1 oco t /prcKVsgii I /cti 11 te/b W i/mr /loco \ /^\n ^/Users/borPus/'App t tc ‘ 
dt t onG: /lJ^TG/tentH2s/torique3t/Di sobey ^con/Oeterqent/Cdde/ i/Users/iicirb ^ 
us/Coriques VD VGPbey, coft/detargent/code/1 eactioroo ;/uGr/XllRG/bi n [j 

SHELL ^ /blnAcGh I* 

IMFOPATH ■ /sw/stnare/Irrfaj/Gw/tnfoi/usr/GhorG/tnfq 

■lxrtvGidtsiRiEy:Vt>«k > |] ^ 


Figure 3: Our reimUen script's (hasvpl) output 
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Our improvernt^nts to the script ure quite loiniiiial additions, 
hut they ensure that user rbita has been properly checked for 
dangerous input, warnings have lx:en enabled for common 
mistakes {>r typos that don't necessarily stop a Mxipt FR>m 
running, and a siriiler development environment has been used 
TO encountge stronger coding and careful variable declaration. 
The revised scxipt is shown in Listing 5. 

Listing 3: Printing the envirtmment more strongly 

Our firvlscfl st fipt is ihaf times sirongcr ilian Ijcfonr. 

#!/usr/btn/perl wT 
use 

print ‘Xpritent-type: text/piflln\Ti\n“'; 

foreach my Svar (beya %ENV) t 
print “Svar = $ENVtSvarl\n“ ; 

I 


I .1 ^5- W 

Prime Base 4.2 
Replication Server 



Check out the fully programmable 

Replication Server 

• Bidirectional Updates supported 

• Update 3rd-party DBMS 

• Send Emails 

• Post/get Data to/from Websites 


• Use warnings; Hie first change, adding -w to the sheliang, 
turns on Perl's warnings pragma, which spits a list of 
optional, non-hita! warnings to Sl'DERR (which becr>nnes 
Apache’s errorjog when run as a CGf). Technically, you 
don’t lo address any of the mess^tges since the script 
will continue on regardless, l>ut tlicw’ll alert you to typos, 
uninitialized values, deprecated functions, and a slew of 
other misha[>s that can evennially estalaie into full-blown 
bugs, 'lypically, tlie messages iire Iei 7 >e enough to be useful 
for seasoned Perl programmers, but you can increase their 
verlxxsiiy !>y adding use diagnostics; within the body of 
your code, 

• Use strict: Our ihird and tbiirth changes compleiiicni our 
warnings. PeiTs Strict jiragma shfiuld lx? used in any script 
that is more than "casual, and ensures thai every variable is 
pre-dedared and kx'jiHzecI, and that other “unsafe coastruets’' 
are detected and adda^ssed. Unlike w'arnings, any error that 
triggers strict will stop your script fnirn continuing further. 
You'll notice that weVe lot'iilized our $var variable witli the 
my() function. Tlie first time you use strict it'll feel like an 
unwieldy and overly doting inotiier, Ijul scripts tliat compile 
cleanly lx?nefit from an attention to detail tliat strengthens 
their quality imnieastdy. 

• Um! taint: Kven though it is strongly recommended", very 
few Perl or CGI scripts use taint mode, which is what the 
—T on the shebang enables. Under this mode, any outside 
data received by your code is considered highly dangerous, 
and will cause script errors until it has iTeen checked for 
safety. These safety checks can be as simple as ensuring 
that a command line argument only contains 
alplianumerics, or that the process you're spawning isn't 
l:>eing handed potentially damaging shell metacharacters. 
While taint mtxle will force you to hx:ys more strongly 
about the evils of the outside world and exactly wfial data 
you expect, programmers who misunderstand how to 


fsOL-BurtW'jSSlct 
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• SQL-Runtime Libraries available 

• SQL Database Server 

• Application Server 

• Replication Server 

• Open Server 

Available on the most popular platforms 


• Completely cross-platform 

• Full-text searching and indexing 

• Mac OS & OS X 
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“untainr data may inadvcrtL'nily do so incorrectly, creating 
a false sense of security, 

These programming additions aren't die ultimately panacea, 
but merely a placet)o. Yes, your code will be stronger with them, 
but that doesn't mean cat eta I bugs won't i:reep in and ruin your 
day. Serious coders and sysadmins should take a kxjk at the 
following sampling of Perl and CGI security links: 

• The Perl Security manpage, accessible by typing man 
peiisec in your Tcnninak can also be read online at 
http://www.perldoc.com/perl5iT/pod/perlsec.html 

• "Avoiding security holes when developing an application”, 
a six pari series from JanuxFocus.org: 
http://www.lmuxfocus.org/English/November2001/artide203shtml 

• SecureProgramming (http://www.secureprogrammingxonn/) offers 
a huge collection of links to over 50 articles, tHK>ks, rccipe,s 
to learn from and adapt, and more. 

• RFID's Ted CGI problems", which appeared in an old issue 
of the seminal Phrack magazine, still remains relevant: 
http://www,wiretrip.net/rfp/txt/phrack55.txt 

• CERTs "How To Remove Mera-characters From User- 
Supplied Data In CGI Scripts'’, in both Perl and C: 
http://www.cert.org/tech_lips/cgLmetacharacters-htmL Handy for 
when you're looking to untaint some data. 

• 'Ilie “Securing Programming for Linux and Unix HOWTO', 
availaldc from http://en.tldp.0rg/H0WT0/SGCure-Programs-H0WT0L 
Similar articles like "The Hack FAQ" 
Chttp://www.nmrc.org/pub/faq/hackfaq/index.html), and the “WWW 
Secairity FAQ" (http://wvwv,w3.org/Secunty/FaqAAAflAA/-sft:uri^^^^ 

will also pn>ve insighdul. 

CHCXWlNt, A CGI SCKIFI^ FOR DEPI OVMENT 
Tile above programming sugge.siit)ns are fine if you're 
solely looking at the ctxle cjuality of a pt^tcntial CGI script, hut 
there are few mt>rc areas to investigate before you can consider 
a program wortliy of lx^ing installed on your .server: 

• Check the Bugtraq archives 

(http://securityfocus.eom/archive/l). Anyone interested in security 
should be reading Bugtraq, where a large community of 
hackers, white hats, sysadmins, and professionals regularly 
post bugs, exploits, and warnings for insecure products. 
Occasionally, youTI also see new whitepapers concerning 
various aspects of security and programming. Before 
installing new scripts, comb the archives to see if any 
advisories liave lx?en posted. If so, ensure iheyVe l>een 
fixed before using the {xxle. 


• Googling for problems can prove illuminating, as you’ll 
often find common tech support problcrns, heaps of 
praise or .scorn for the code or author, and occasionally, 
other w^eb hosts who offer the script for their own 
customer base. 

• Check the dates: Wlien was the script last updated? Is it so 
king ago lliat no one will give a darn if you have a problem? 
Just because a script doesn’t have any reported problems in 
Bugtraq doesn’t mean that it isn't susceptible to relatively 
new exploiLs like cross-site scripting attacks 
(http://www.cgisecurity.com/artictes/xss~faq.shtml). Code that has 
been updated recently has a better chance of good 
turnaround time for crucial fixes, updates, and support. 

• Got logfiles? Masi CGI scrif>ls don't have any logging 
capability, primarily l>ecause they only do one small thing 
(like email forms, add one to a numbcT, display a calendar, 
etc.) Some compltcaied scripLs, however, can l>enefii from 
logging, especially Llitjse with built-in user auihenliaiiion 
(“who is using my site?”) or flaw' tracking (“a hug occurred at 
Itimef and things turnetl awry* [like thisl”). Scripts can use 
their own logfiles or Bed's Sys::Syslog module to log 
directly to Arar/log/sy Stem Jog 

IlOMKWORK MaUGNMEIVTS 

In our next column, we'll move on lo configuring PHF, us 
well as explain the up- anti tiownsides Ix-Uweca forking 
processes (like CGI) and embedded mixlules flike modjlhp). 
We’ll explore the default configuration of PI IP, the non-existent 
configuration file fphpJnfi and, if we have time, how lo install 
MySQL and do u few infegnition tesi.s. For now, students may 
contact the tcrat her at morbiis@di5obey.com. 

• Besides -w, you can also enable I^erl's warning pragma with 
use warnings, (similar lo use strict;), Subtle differences 
exist ixMween the two—research them and find oui which 
sittisfies your prf>gnimming needs better 

• Any Perl script with logging may eventually nin up against a 
perceived “buffering” problem, ihe sordid dctail.s of which 
are explained in Mark Jason Dominus' “buffering from 
Buffering?” (http://perl,pioverxom/FAQs/Buffering.html). 

• If you’re looking lo baish tip on your Perl knowledge, you 
can’t gf) wrong with O’Reillys iMirning Ihe Peri 
(Axfkhook CwJiich just received an impres.sivc Second Edition 
update), and the recent Learning Peti Objects, References, & 
Modules, You ('an read sample cliaj^ter.s from all the bcK)ks at 
http://www.oreilly.com/. 
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See Dick. See Dick run his business 
with software that wasn’t written 
and designed for his Macintosh. 

Poor Dick. 


A momenc of silcjicc for Dick, plcaiic. A g(x>d 
guy wiih a good small busitie5s> but his accounrmg 
software was one of those PC? transcription iohsj 
not pure MAC like MY( )B AcoountEdge and 
MYOBBmFalgc. , _ 

If only lieci known about the amazing capacity of MYOB 
software to bring out the best in his MAC operaiitig system- 
He ctmid have Tracked and managed fitmices at a glance or generated all the 


reports, invoices, and tax documenrs that he and his accoujitam would 
ever need* He could have spent more time with his clients* 
If he had only known that MYOB develops the worlds 
best selling MAC small business management 
software for lots of good reasons, tfiis story 
might have had a happy ending. Sorry Dick* 

MYOB, 

THE MAC ANSWER* 

etaXJJ WrOB us. iuc* (msuiiJ J-VIVOB www. m 
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SOFTWARE 

MARKETING 


By Da ve Wooldridge 

Building a Business 


Marketing is Not a Dirty Word.,, Ready. 


M:irk€‘ting and sales — rhe two words rhat niake mosr 
devekspers cringe: even more than hug i-eports. Wliy the dread? 
For many of us, ilie elusive world of marketing is unknown 
territory. Sure, we can spend countless hours prognimniing 
complex algorithms, bnl hand us a marketing plan with 
spreadsheets and sales forecasts, and we all start to squinn in 
our chairs. Of course, we’d rather spend our time developing the 
next ''killer app.” hut if you’re an independent developer who 
depends on software^ sides to pay the hills, llien marketing is an 
unavoidahle task. With careful [planning, j:>atience, creativity, and 
a little help fiom this new monthly colutnn, it hopefully w'on’t 
seem so daunting. 

The goal of diis column is to deniysiify software 
marketing. Can’t afford a huge adveiiising campaign or a 
dedicated sales staff? N{jt to worry, you don i necessarily need 
a big hudgel U) build a successful .software Ixisines.s. Each 
month, We ll focus on a different topic such as promotional 
opponunities, distribution, publicity, press releases, sales 
incentives, web site strategies, etc. We II explain how to 
quickly and easily integrate these cost-effecLive concepts into 
your own development plans, 

MYTH: Buiu> Ii and They will Come 

Okay, this isn’t “Field of Dreams," people. So yuii've 
built an amazing shareware application. You post a 
download link on yottr web site and submit a listing to 
Versionrracker.com. Yoti receive several positive comments 
and even net six or seven sales within the first few days. 1’he 
initial flurry of activity is prtunising. Yoti l>ecdmc t)piimi.stic, 
thinking ihLs could be your ticket. This could be your 
flagship product that helps you launch the software empire 
you've always dreamed of running. Another week goes by 
and sales dwindle into noihingness. No iiiore dtnvnloads. No 
e-mails. l\ s as if your product doesn't even exist. It’s lost in 
the endless .sea of the Version Tracker archive.s - its only 
chance of surfacing again is when you announce y<)ur next 


update. Only if there’s no demand, why put the energy into 
updating a dead product? And then you remember that other 
great shareware idea you had and decide to pursue that 
instead. Sound familiar? 

As developers who pour our l^locxl, sweat, and tears into 
progmmming, we often have little energy k:fi ro foe‘its on 
marketing the final producL After slaving away lor six montiis to 
finisli one application, there's an overwhelming excitement to 
unleash your new baby to the world, eager to receive affirmation 
from users that all the hard wcjrk was worth it. But in die rusli, 
imponanl .steps that can help ensure a long and successful life 
for your [iroduct are often bypas.secl or overlooked. 

No developers want to see their products fail. Even 
lliougli we all realize tlial marketing is crucial, die dilemma is 
often liow and where to start. Looking for a good book on the 
subject? Good luck! Most Intsiness books tend to describe 
ahstrac't marketing t'oncepis that cater to the widest spetirum 
of readers, leaving software developers uncertain as to flow 
these general themes can be applied to their specific marketing 
needs. To assist our readers, .MacTech will offer a different 
approach. This column will show ytju practical, costHL^ffective 
marketing lechnitiues and opjxHtunities throughout every 
stage (vf a fictional software prmiucl’s life cycle, illustrating 
real-wT)rld examples. 

While this first insialliiient may seem elementary to some 
veteran developers, it .shtJiild serve as a good entry point for 
those programmers new- to the software business Ijefore we dive 
into specific topics in the following months. 

Do Your Homework 

Marketing does not start witli the final product. It begins 
with the initial concept. Ever think of a cool software idea, 
only to find out that twelve similar applications have already 
lieen released? Sure, many (jf diem are probably amateurish 
attempts comfiared to your product, but the problem is that 
they exist nonetheless. The saturated market increases 
consumer confusion ^ sometimes ihere are just too many 
choices. Obviously, your com[)etjtor.s are going to boast that 


Dave Wtx>Idridge is ihe kjuncler of Fletiric BiirterOy (www.ebutterfly.com), the web design and software company re.sponsihIe for Stimulus, HelpLogic, 
IJniHclp, and the popular dcvciuper site, RBGarage.com. 
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iheir producLs Ate the besi, so how many dilldrcni. soliw^arc 
applications will consumers lx- whiling to evaluate before 
stumbling upon yours? And will they even get to that point? 
Or will they give up somewhere along their cjiiesl and pick 
sonic mediocre pn>duct thai meets only some of dieir needs, 
not knowing your product will better serve them? People are 
typically impatient and desire quick solutions when 
shopping for software. If iliey can't easily find the diamond 
among the rocks, they will often settle for anything that 
remotely glitters. 

The pf>in( here is that if yoiTre going lo release a produd in 
an already over-sat urn ted market, then you need to devist^ a way 
to make your prtxiuct stand out from the pack. 1 here should lx 
a unique benefit or feature that sets your product a pan from its 
cumfxtitoj^. Let’s l(x>k at the cnrwded field of software note 
keepers. These handy little utilities alkw yt>u to store and 
quickly access notes, passwords, clipboard items, images, 
sounds, and more. Searcli for “notes'" on VersionTrarkera:oin 
and more than 50 product listings will apfxur. Most of liiein 
claim to lx the most tiiiie-saving, general purpose notes 
organi:?:er on (he market^ s<j how will your application be 
differenL’ What will lx the key-selling fxnni tliai makes your 
product special? 

To answer those cfuestions, we miLst start with research. 
Investigate the software c:alegory you’ir planning on entering. 
Now it goes without saying that the best niches to fill are those 


that remain untapped. It's fairly easy tt) dominate a specific 
market if you have no compeUtors, ):nit let's assume you're 
entering the crowded note keeper category, which already has 
several key leaders ancl dozens of fledging underdogs. Before 
you even think of opening your IDE, before wTiting a single line 
of code, your first job is to thoroughly research each and every^ 
one of your com pet lions. 

Visit your competilors’ web sites and reail any reviews and 
related online forums you can find. Figure out w^hat it is al^out 
the market leaders that lielp them outsell the otlier products in 
(hat field. Is it a specific fealure .set? A polished, ea.syqo-use 
interface? An unbeatable [>rice? A combination of elements? The 
game is about filling a niche or need that isn"t being pro|xi1y 
addressed. Your goal is to convince as many people us possible 
that ytiur software is not only a w'ortliy choice, hut the ONLY 
choice for litem to consider. 

Even though we're developers, we’re also consumers. If 
you were to purchase a software utility for organizing small 
chunks of data, what would you use it for? SUxing code 
snippets, maybe? Ah, might be onto something here. Yes, 
you coukl easily paste important axle fragments in any notes 
keeper, inil undoubtedly, some vital features wtjuld be 
missing, It would ix nice if these code snippets could be 
viewed with syntax coloring. And it w'ould be nice if the 
interface was small and compacl enough lo run ahmgside your 
screen-hogging IDE, giving you quick access lo your library of 
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code snippets. Sounds like great product for software 
developers and web site designers. 

Searcfi VersioriTracker for “code snippcLs” and lliis lime, 
only two results are found. Not only have we defined attractive 
key-selling points tailored for a specific target market, but we 
also found a niche c.alegory with very few competitors. 

Before jumping into development, we should stop to 
consider our coniniitment to this particular project. Growing 
a loyal customer !>ase For a new prodna lakes a \o\ of 
patience and hard work. As the developer, you have to 
determine if this project will susmio your interest over years 
of dedicated programming and hbar poured into continuous 
updates, cu-slomcr support, and marketing. Do you have 
creative ideas on what new features to add in version 2.0? 
Any thoughts on version 3 0? It Ls important to develop a 
long-term game plan for the prodocl’s future releases. This 
will not only give you a development direction so that you 
can properly build an extensible application framewnd^ to 
accommodate those future plans, but it will also help you 
gauge your interest level. 

So who cares if the product lasts three years or three weeks? 
Your aistomers care! tliis is where your dedication to continue 
supporting a prtxiucl directly affects your tnarkeling and sales 
success. If you stop prtxlud development and support after only 
the first 1.0 relea.se dtie to a lack of interest, your abandoned 
aistomers will lx:comc skeptiral and imirusting. Tliey may never 
buy anoliicT of ytjur [)r{)duclH - a fate you sliould des[)erately try 
to avoid since the bigger goal here is to build a profitable 
software company, not drive husines.s away. 

A new product should never be dropped after only one 
release because of disappointing sales. Instant success rarely 
happens right out of the gate with version LO. It takes time to 
spread awareness for your new product, so your dedication to 
the project iiiu.sl remain strong. Just remember that maintaining 
the happiness of your existing customers is very important 
since you will be depending f>n them for upgrade sales anti 
spreading positive comments ai)out your software to their 
friends, co-workers, etc. 

So now that weVe com mitred our time and resourc:es to this 
project, the next slef^ is to give our fictional ccxle snipfiet 
organizer a natiie. A gcx)d name is extremely impoilanl and can 
make or break a product's success, Put a lot of thought into it, 
Write dovvn at least a dozen dilferenl names. Why scj many? 
Because 1 can guarantee that most of them will already be taken. 
Perform searches for each one {>f your name ideas (with and 
wiihoui spaces) on VeisionTracker.com, MacUpdate.com, 
Google, and lire U.S. Patent & Trademark Office (www.uspto.gov). 
If a name is already in use, then scratch it from your list, even if 
it’s not a software prcKlnct. Companie.s are very protective of 
their registered names and trademarks (as they should be). You 
don’t want to sj>end six months of developnieot time and your 
hard-earned marketing money, only to receive a “cease and 
desi.sf' letter from someone’s lawyer 


The name should help describe the fiinaion of the 
produa, so that if a consumer sees the name listed in a catalog 
or web site, it might ])ique their interest even if a description 
is not available. With this in mind, iPs probably important to 
include the word “code’’ since we are attempting to appeal to 
programmers. “Code” might be (x'st coupled with another 
word that represents a collection, a library, or some sort of 
storage device. CodeBase, CodeBank, CodeFarm... all taken. 
After penising the dictionary and thesaurus, I find the word 
“quiver.'' 11mm, CodeQuiver. Has a nice ring to it and it rolls 
off the tongue quite easily. Plus, the symbolism is perfect for 
the application, A cjuiver gives an archer c|uick access to 
arrows (your code) when firing at a bullseye target (your 
programming task). 

BRA.ND IDENITIY 

Now that weVe established the development direction and 
a name, our next assignment is to design a prtxluct logo and 
icon. The objective is Lo lie a sfKxafie image to the application 
that becomes synonymous with the product. This visual aie 
should Ix^ unique and simple in nature, something that can be 
easily identified by consumers after repeatedly .seeing it in 
advertisements and online. 

Why is visual branding so impoitant? How many time.s have 
you said, “1 ain’t remember that person’s name, hut I would 
definitely retognize tlieir face.” We all lend to rely t[uite heavily 
on visual stimulus, so why not lienefit from such a simple 
marketing tool? If the goal is for consumers to remember your 
software^ name, then provide them with a visual cue to helf) 
solidify it in memory. 

A perfect example of a successful branding strategy is the 
popular Fl’P program, Fetch. Most Mac users are so familiar 
with the little brown dc)g with the blue disk in his mouth that 
Fetch Softworks’ current advertisements (which appear 
regularly in Maclech) do not even mention Fetch’s core 
functionality. One ad simply shows the Fetch mascot with the 
title “Good Doggie." Although Fetch has continuously 
evolved along with the latest Mac 0$ advancements, its brand 
identity has always remained con.sLstent (see Figure 1). The 
visual connection reinforces consumer recognition. Over the 
years, Mac users have gradually grown to identify the Fetch 
name and icon with FTP. 

Establishing a new brand docs not happen overnight. 
You may release several versions before your software's logo 
and icon I’lecome familiar to potential buyers. IPs about 
frequency and continuous exposure. Tliai's why getting 
reviewed in magazines and getting listed on software sites is 
so important for shareware titles. Even though Fetch 
Soft works' current marketing strategy includes advertising, 
the branding of Fetch's little brown dog was being 
emblazoned into the minds of Mac users long before the 
recent print ads. Rack in the early days of the Mac, Fetch was 
one of the first, easy-to-use FTP applications, h was 
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originally developed by Jtni Matthews and released as 
shareware from Danmouih College (where he worked). With 
only word of mouth, Fetch bet'anie one of the defacto FIV 
utilities for Mac users. Fvery release featured the little brow-n 
dog with the blue disk in its mouth. When Jim Matthews 
purchased tlie Felcli source code and name from Dartinouth 
College in early 2001 and started Fetch Softworks, the Fetch 
mascot was already one of the most recognized icons in the 
Mac community. 



figure 1, From ihe early of Mac (Left icon) to Mac OS 9 

(Middie icon) to Mac OS X (Right iamf the ujell-knottm 
brand identity of the Ixiindar FTP program. Fetch, 
has remained comistent. 

So how docs one esLal>lish a visual !>rand? Include ytjur 
product logo atid icon in everything! Don't stop at your 
application icon. Integrate the imagery into your software's 
inierlace, documental ion, advertisementii, your w^eb site, etc. 
Everywhere yoLir product name is mentioned, its related icon 
should accompany it whenever possibie. Obviously, things like 
text-only pre,ss releases are the exception to thus nile. 

In designing an icon for our fictional CtjdcQuivcr 
product, the name makes the task quite easy. An archery 
target with an arrow in the bullseye provides a powerful 
visual that helps reinforce ilie product name, as well as a 
simple image that will still be easy to identify when 
shrunken down to a small 32 x 32 icon (see Figure 2). Even 
though Mac OS X utilises Ijeauttful 128 x 128 pixel icons, 
there are times when the icon will be view^ed in the Finder 
in sizes as small as 16 x 16 pixels. An effective icon is one 
that looks good at any standard icon size and resolutifjn. 
Remember, uniclenlifial?lc icons do not add branding power 
to your product. 

Since the icon imagery will supply mo.st of the ctrlorful 
eye-candy, the title treatment should remain clean and 
simple so that the overall logo does not appear cluttered and 
busy. Using a sans-serif Font, only the “Q” is enlarged, with 
its bottom ^'hook” straighlencd to the same angle as ihe 
arrow to make the look like a quasi bullseye target (see 
Figure 2). 

Don’t have a single artistic bone in your body? Not to 
worry, there are lots of freelance artists out there that 
specialize in logo and icon design. With the Internet bringing 
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tliL" world to your fingertips ^ it’s fiiirly easy to find an 
inexpensive graphic designer online. Many shareware 
developers have henefiled from their own customers who 
have offered to redesign their interface icons in exchange for 
a free license. And if your product sells for less than $100, 
then that's I he cheapesl design work you 11 ever find! While 
this is a great trade for you, it's unfortunately a bad indication 
that your product is being ill received. If the top feature 
request is an interface redesign, then acquiring help from a 
prorc.s,si<)nal icon designer - even if you have to pay for it - 
will be worth every penny in the long iiin. 

Your Inttrfacf is a Marketing Tcx)l 

Whenever the words “interface” and ''marketing” are used 
in the same sentence, there are usually a handful of 
progntmmers who cry foul, afraid that the imaginary chtirt h and 
state line lx:Lwecn development and fjusiness is being blurred. If 
tliat result,s in selling more software licenses, then how^ can this 
be a bad thing? 

If youTe a sharew^are developer, then many of your users 
may stumble uixm your product on a shareware compilation 
CD-ROM or a softw^are archive site fUl discuss how to get your 
sofrw'nre titles distributed to all of those vital aiulers in a future 
column). Witlioui the lieneOl of seeing your web site lirsi, the 


Whistle Blower 

Enterprise server monitor and restart utility 
whistleblower.sentman«com 

Connect to and validofe the response from web servers, 
eg/ senpfs and over 23 other types of servers. 

Send email, pages and perform unattended restarts via 
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Web based ac/m/n/s/rahon lets you check on and restart 
your servers from anywhere. 

Customize your response to an outage with Ap^ple Script 

email us at whi$tleblower@sentman,com 


application dowaiload setv'es as the user's Urst exposure to your 
prodtici. Yon c:an add a Oarning red icon Uj tlie included '‘Read 
Me First” file, but odds are, users will lazily bypass any 
documentation and simply double-click on your application, 
knowing nothing alxHiT your product except iLs name and a bnef 
one-line description. 

So it essentially comes down to first impressions. A 
user's first impression of your interface is going tt> be one of 
the primary factors in deciding whether or not to purchase 
a license. When dealing with shareware and trial versions 
that consumers can freely evaluate, your application’s 
interface becomes the most important marketing tool in your 
arsenaL The interface is itis own best advertisement, so take 
the time to ensure that it looks good, while reinforcing your 
product's brand identity. 

To alter lo our largei market, weVc designed CodeQuiver's 
interface as a compact, vertical palette that can sit in the comer 
of the desktop scieen alongside your favorite IDE. We could 
closely follow Apple's Human fnierface Guidelines and develop 
a fairly generic Aqua interface (Left exam]:)le in Figure 2) or we 
C(^ukl interject some branding to give the inrerface a little 
persfmnliiy (Right example in Figure 2). More cries of 
hla.sphemy arise from tho.se developens wlio finnly clutch the 
Human Interface Guidelines as if it were their hible of trutli, But 
even Apple has ilefied its own guidelines from time to time. 
Nothing’s written in stone, Tiiafs why ilieyTe called 
‘"guidelines” and not "ruie.s.” 



Figm^ Z Sometimes hrmking the nites is good business. 

Although the U^ft example may amform lo Apple's Human 
Inlerface (kiidelines, the Right example provides a professional 
jxAish that enhances the user experience. 

Notice how all of the best-selling Mac .software titles have 
their own unique interlaces? They all look like stancLird Mac 
applications, but each and every one of them defies at least 
one item in Apple'.s Human Interface Guidelines. Their unique 
look and feel is what gives them personality. Consumers may 
not inimediarely notice the subtle niceties of a specific 
interface, but it does subconsciously affect their user 
experience. The iniegraLed branding - whether it’s illustrated 
through unique toolbar icons or through the creative 
placement of the product logo/icon - adds a professional 
polish m your application that may enhance an otherwise 
generic interfaec (Eight example in Figure 2). 
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I'HHOlIGH THE IX)OK!NG GlASS 
While we're on tlie .sul>jeci of first impressions, tlie l)nind 
identity of your product should also l)c properly represented on 
your web site. If people follow an Ul^ from a magazine review 
or advertisement to your site, only to find a very' basic web page 
witli little more titan a download link and a version nuin[)er, 
you’re doing a major disservice to your software business. 

Take a look at the two web page examples in Figure 3. 
The lefi example pnjvide,s minimal prodiia informalitin with 
only a one-line description. Interested users are then expected 
to download and evaluate the software. Most people are 
extremely htLsy and don’t want in waste the time downloading 
and testing an application just to learn more about it 
(especially if they use a slow dial-up modem). At this point, 
many of these people lose their initial interest and turn away... 
and yoirve just lost those potential sales! And why? Becau.se 
your web site did not provide the detailed product information 
that consumers were looking for. 



Fiffut'e J. Which site wouki ytm tnist mme mtb ymir 
credi! card? Consumers see your site as a looking 

glass into bow you run ymir business. 

When you shop online for softw'^are, whal arc die key 
pieces of information you want to see? At a minimum, this 


should include a brief product description with a detailed list 
of features, a few screenshots of the application in action, 
system requirements, price, and what kind of customer 
support is ofFerecL 't he Right example in Figure 3 shows an 
enhanced web page design that includes these key pieces of 
informalion. The purpose of your web siie is lo not only 
provide a download location for your software, but to hel[) 
promote and sell your products. Your job as a marketer and 
.salesperson does not stop until a customer purchases your 
.software (and even then, you 11 want to keep that sales 
channel open for future upgrade offers). This means that 
everything that leads a customer ro that purchase point must 
continue to innucncc their decision, and your w^eb site is a 
majoi' part of that etiuation. 

Your web site is your storefront to the world. People 
judge your stjftware and your business by the way your web 
site looks and functions. If your site appears too basic and 
sloppy (as in Figure 3's Left example), it gives the perception 
of being an amateur .shareware outfit. If the developer does 
not cure enough to stKmd time and money on his/her 
business, then wliy should a consumer? Having an elegantly 
designed web site will not only make your business and 
produels appear more professional, but it will instill 
something very valuable in your customers: TRUST. Again, it’s 
always about first impressions. When comparing the two 
examples in Figure 3. which .sire would you trust more with 
your credit card? Which site looks like a business that will 
continue to support their products one year from now^? T\vo 
years from now? 

II you don’t have much experience creating wel^ 
graphics and HTML, then iFs in the best interest of your 
software business to either hire the assistance of a freelance 
web designer or learn how to do it yourself. Macromedia 
Dreamweaver and Adobe Go Live are just a few of tire great 
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web site creation and ni;magement tools that can make the 
task easier. 

Still using that free community web space from .Mac» 
AOL, Earthlink, GeoCities or Tripod? Most consumers are 
savvy enoygli to spot the teUing LIKE address of one of lliese 
free hosting accounts (especially if you list it in an 
advertisement), it is yet another element that oozes the word 
**amateur" or “hobbyist." If you want people to perceive you 
as a professional software company, tlten regLstering a domain 
name (such as www.mycompariy coin) is a wise investment. At 
only $35 a year (average US cost), domain names shtnild be 
an essential pan of your marketing mix. You can register 
produet-related domain names like WWWXodequiverxom, but 
your [iiarkeiing efforts should always refer to your company 
domain name since yon want people to a,sscx:iate your 
products waih your company. This is important when 
launching a new product in the hQ|>es that customers will 
renieml:>er how nnich they like your other software and 
assume the new CfxleQuiver muM be just as cxx)!. 

Some developers believe that fancy web sites are a 
waste of time because in the end, it\s the quality of the 
software itself that ultimately convinces users to buy a 
license. While tliis is true, it does not account for 100% of the 
decision making process. Most people know^ who 
Macromedia and Adolie are, hut few shareware companies 
have that kind of name recognition. Omsumers fear the 
unknown, so as an unknown entity, your job is to alleviate 
that fear through your marketing messages and your web 
site. Customers are nor jiLsi buying a product, they are 
investing in your business, trusting that you will continue to 
suj>port and update your pn^duct. 

Think Bui Fi<TtfRE 

Before diving into specific topics in future issues, the 
goal of this first in.stailment was to illustraie the imponance 
for independent developers to sc‘e the “big picture." Building 
a .successful software lousiness requires a lot of strategic 
planning. While research and imerface design are typically 
considered parr of the product development process, 
everything you da up until liic initial release directly affects 
the marketing and lifespan of your product. Establishing a 
brand identity and positive first iinpre,sslons for your .software 
and busine.ss should never be aflerlhoyghls. Tliink about your 
marketing strategy throughout every phase of product 
development. Having a well-conceived game plan will save 
you from the many developmeni headaches ihai impulsive 
decisions usually cause. If you alw-ays think “big picture," 
you're one step closer to a long-lasting product line. 

Next month, we'll explore several marketing Uxrls and tricks 
that you can integraie into your web site to help increase 
awareness and sales for your software. 


Tlie Fetch icoas appear courtesy of jiin Mattliews, Fetch Softw'orks, 
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QUICKTIME 

TOOLKIT 


hy Tim Monroe 


Children of the Revolution 


Editing QuickTime Movies with Revolution 


Inihoduction 

In the previous QuickTime Toolkit article (“Revolution” in 
Maclech, September 2003), we took a Him \ook at Revolution, a 
rapid applicaLion developiiieni tool published hy Runtitiie 
Revolution Lid. We saw how lo create a new application — 
which we called RunRevVeez — dial can open and display 
QuickTime movic-s. We saw liow to set things up so that die user 
can have several niovies open at once, and we saw how to use 
a few of the built-in Revolution commands to mcxlify the 
appearance of a movie player ohjeci al nmtime. In Lernis of 
movie pkivlTdck, RunRevVeez is jusi about complete. 

'I'he situation with movie editing is somewhat different, 
however As 1 mentioned hrst time, Revolution has no built-in 
support for edidng QuickTime movies. In addition (as fur as I 
can tell), ii provides no support for tracking changes to a 
window or document, and it provides no way to save an edited 
movie. We’d certainly like our applk ation lo \w able to handle 
diese tasks, so we'll have to go lieyond the built-in capabilities 
of Revolution. We need to write a Revolulion plugdn. 

Happily, Runtime Revolution provides a software 
development kit (SDK) for writing Revolulion [dug-iiis, and this 
makes wTiting our plug-in a snap, With just a few^ do 2 en lines of 
new C code and a handful of routines borrowed I nan our existing 
C-based .sample application QTShell, wc‘ll he able lo handle all 
tlie basic editing oix^rations, keep track of the modification state 
of a movie window, and save eclited movies inio new files. 

Unhappily, even w'itii this plug-in, there are a few things we 
won’t 1>C‘ able to accomplish with Revolution. The Revolution 
runtime engine opens Quicklime movie files with read-only 
permission, which effectively preveius us from saving any 
changes to a movie into the Ole we opened the movie from. We 
will be able to WTlte an edited movie into a new' file. (In a 
nutshell, w'e’ll be able to implement the "Save As” menu item but 
not the Save iiieriu item.) Also, the Revolulion amiime engine 
installs a movie controller action filter procedure, which 
effectively prevents us from instaUing our own procedure, 'lliis 
restrUis our ability to access many important QuickTitnc 


capabilities. (You may recall tliat REALJ:sisic currently has this 
same limitation; see “Basic Instincf' in MacTech, Februaiy\ 2003) 

In this article, we’ll contimie our development of 
RunRevVee:^. Well implement the editing oixiTations on a movie, 
whtcli requires us to develop a plug-in and then to call the plug¬ 
in from within our scripts. Well look at the file-handling 
operations (principally, "Save As" and Close) in the next article. 

One final note before we begins Runtime Revolution has 
recently released Revolution version 2.1, In these articles, Tve 
used version 2.0.2, I would assume that the plug-in and 
Revolution project will work unchanged under 2.1, Iml 1 have 
not actually verified that. 

RF.V0!.1]T!(>IN PrOCi-lNS 

The Revolution runtime engine is based largely on an 
existing product called MetaC^ird, which was introduced in 1990 
as a eompetittir to Apple's MyperCartl. Not stirprisingly, the plug¬ 
in architetlure used by MetaCard, and hence Revolution, is 
identical to llial introduced by HyperCard. HyperCard cun be 
extended by adding modules of commands and fundions called 
externals. A set of external commands is called an XCMD and a 
set of external functions is called an XfCN. 

Originally, XCMDs and XJ^CNs were packaged as 
executable code resources that were added lo the resource fork 
of tile appliaiiion or to the restiurce fork of a stack. MetaCard 
and Revoluiicjn followed this example through Revolution 
version 1.1.L In version 2.0 and laler, the packaging of 
externals was elianged; in eurrenl versions, externals on Mac 
OS X are [>ackaged as bundles, which can be copied into the 
application bundle. 

Tile packaging actually doesn't really matter all that much, 
since it will i>e taken eare of by tlie project files provided with 
the plug-in SDK, The current SDK providers projea files for lx>th 
Code Warrior and Project Builder. In this article, well work with 
the Project Ihiilder version, whose project window Ls shown in 
Figure 1, (Notice that Fve renamed the project as "Ql'External".) 
Well need to nifxlify only one file here, extemal.c. The file 
XCmdGlue.C contains a number of support routines for the 
external; we won’t need to call any of those routines. 


Tim Monroe is a inejiiber of the Quick! ime engineering team at Apple. You can contact him al monroe@mactech.COnn, The views ex[)res,sed here are 
nor neces.sarily sliared hy hi.s empJfjyer, 
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Figure 1: The Project Buiiderprqiect 


Connecting to the Huntinie Engine 

Our Revolution external will define a number of procedures 
and functions that can lie c'alled by RunRevVeez scripts. To 
expost! iJiost! routines lo lIjc mnlinic engine, we need lo declare 
two global variables, Xname and Xtable. The Xname variable 
specifies the name of the external; 

eharXiiamctl = "QuickTime Rcvolutioii External"; 

'I'he Xtabie variable contains an array of procedure specifiers. 
hac:h enti-y in the array speciiTcs information abont a single 
external function or command. Here's our array: 

Xtemal Xtabie [] = t 

t"mcInitiaii^e^ XCOMHAWD. 0* XCMD^HUInitialize. 

XCHI}_Abort] , 

PotcUndo". XFUNCTION. 0, XCMD MCUndo. XCMD_Abortl. 

{"mcGiit". XFUrtCTTON, 0. XCMD MCCut. XGHD Abort H 
rmcGopy". XCUMMAm. 0. x™_MGCop7. XCMD_AboE:t] , 

{"mcraatG'P XFUHCTTOK, 0, XCMb.MCPafttii. X€HJ)_AborT] . 
I'^nicClcar". XFUNCTION. 0. KCKU^HGClear, XCMD.Abort] . 
P^selectAll". XCOHMAND. 0. XCWU^SelectAll. XCHU^AboiLh 
l"selGctNone", XCOMMAND. 0. XCHD_SGlectNone, 

XCMD_Abort!. 

|"inf!EnableEdii:MenuIteni". XFUNCTION, 0, 

XCKD.MCRnableEditMenuItnin. XC:ND_Abortl . 

( "wiiidowSetModified". XFUNCTION, 0. 

XCMD_SGtWindowModif ied. XCMB_Abot:ti . 
l"saveAs". XFUNCTION. 0. XCND^SaveAs. XCMI>_AbortL 
I"", XNONE, 0. NULL, NULL} 

}: 

Tlie first item in a procedure specifier is the name of the routine 
that we'll use in our scripts. The second item indicates the type 
of routine; ir\s XCOMMAND for commands (w'hicli do not reium 
a value to tiie caller) and XFUNCTION for functions (w'hich do 
return a value to die caller). The third entry is used by the 
mntime engine and should lie set to 0 by our external. The fourih 
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entry is the name of the coi responding C language routme in the 
external. On other words, it’s the routine that Ls called when our 
script executes the first item.) ['inalJy, the fifth item is the name 
of an ahori routme, whicli is called when the user cancels the 
execution of an external routine. All our external rouiines will 
use the same abort routine, shown in Listing 1, 

Listing 1: Handling user cancellations_ 

XCMD.Abort 

void XCHD_Aboi:t t) 

( 

DebugStr("\pQuickTiiiie Revolution External abort"): 

1 

Our alx)it iDutine just prints a diagnostic message on the 
standard error output. 

Handling Commands 

When a script calls the mclnitialize cotnmand (for instance), 
the external function XCMD_MC Initialize is executed; 
XCMD_MCInitialize has this dedanuion: 

void XCHD_HCInitialize (char *args[]. int nargs, 

chat ^'retstritig, Bool ‘pass. Bool “error): 

Tlic first [laranielLT [lassed It) XCMD_MCInitialize is an array of C 
strings chat specifies the panimeters tlial were [lassecl to the 
mclnitiatize command. The second parameter specifies the 
numher of items in that array. We’ll call mclnitialize with only one 
paranieten like this: 

put the raovieController ID of player "MoviePlayer" \ 
of stack newStac3<lianie into me 
TEC Initialize (me) 

*J'he third parameter, retstring, is a pointer to a C string that 
contains ilie results of the external rcnihne. For procedures, this 
is ignoretl by tlie iiiniime engine; for funciitjns, this string is 
returned to the seript as tlie command result. Tlie buffer for this 
siring must be allnc:ated by the external and is di.sposed of by 
tlie runtime engine. 

The fourth and fifth parameters are used to jrass otlier 
information back to the niniime engine. The pass parameter 
indicates whether we W 2 mt tlie command (in this cuse, mclnitialize) 
to passed up the message hiei:archy after it is executed. In 
general, we shall return false in this panmieter 'Ihe error pammeter 
indicates the success or failure of The external routine. Once again, 
we’U alway.s pass hack false, to indicate that no error occuned. 
(Hnors may indeed occur wTthiii our external routines, but 
RunRevVeez will have no capability to w^ork around errors; so 
there’s little fK>int in Idling it know that .something went wrong.) 

Configuring the Movie Controller 

So let's see how we can implement the handler for the 
mclnitialize command. As weVe .seen, the args paramder will 
contain a .single C string, which is the movie controiler 
identifier encoded as a string. To get a value of type 
MovieConlroller, we need to convert the string to a long. 


me =* {MoYi6ContrQller)atol(argsfO]): 


Once weVe got the movie cojitroller ideiitifien we can call any 
QuickTime APIs that operate on a movie controller. In 
RunRevVeez, we need to enable editing (by calling 
MCEnableEditing) and enable keyboard event handling (t>y calling 
MCDoAction witli the mcActionSetKeysEnabled selector). Listing 2 
shows our complete handier for tlie mclnitialize cotnnumd. 

Listing 2; ini tiallying the movle cont roller _ 

XCMD^MClJiiliali/i: 

void XCMO Mclnitialize (char *args[]. int nargs, 

char ““retstring, Bool ‘pass, Bool ‘error) 

I 

HovleController tac = NULL: 

ComponentResuit result aoErr; 
char ‘retstr ” NULL: 

// initialize the movie ctminjMcr as desired 
“pass = false; 

'^errot = false: 
if (nargs =1) I 

ETC - (MovieControilar)atol (argslOl}: 

if {me !“ NULL] I 
// enable editin^j 

= HCKnableKditlng(mc> true); 

// triable kfytxianj event liaiidliiig 

MCDoAction[fflc. mcActionSetKeysEnabled. (void ‘)true) : 

// disidile drag sujijxiri 

MCDoAction {fir . mcActlonSetDragEnabled , 

(void “)false); 

I 

1 

retstr “ calloctl. Z): 
if (retstr I- NULL) 

retstr [nj = (result = rioF.rr) ? 'O': 

* re Lairing = retstr; 

I 

As indicated just above, we set botii pass and error to false. And 
we pass back, via retstnng, a C siring of length 1 that contains 
either '‘O" or “1". RunRevVeez ignores that value. 

Once weVe successfully called mclnitialize, the thiunh in the 
controller bar will change to reflect that editing is enabled (as 
seen in Figure 2). 


e © Sample Movie 



Figure 2: A moide mndow with editing enahk^ 
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Handling Edit Operations 

So, weVe enabled movie controlier editing. Now we need 
In fiandle the vanous editing operations. In these cases, we need 
to pass a value Ixick lo tlie oiler, indicating whether the 
operation completed successfully. Tliat’s so RunRevVeez can 
know to set the movie window as modified and that the movie 
has changed since last opened or saved. Well return the string 
“1” if the edit operation fails and '"0” if it succeeds. Listing 3 
shows how we'll handle the meUndo command. 


Listing 3: Undoing a movie edit 

XCMD_M(jrndo 

void XCMt)_MCIIntio (char “argst] < int nargs, 

char **reLstrlng. Bool ‘pass, Bool ‘error) 

I 

HovieCont caller tne “ NtlLL: 

CoaponentRestilt result * noErr; 
char 'retfitr ** HULL; 

‘pass ^ false; 

•error false: 
if (nargs “= 1) i 

me “ {KovieContcoller)atoiCargfi[0]); 

if fme !- NULL) 

result ” HCOndofac): 

J 

relslr = callocd, 2); 
if icEtstt t- NULL) 

retstr[0j (result noErr) ? '0‘; M‘; 

‘retstrlng * retstc; 

I 


We simply retrieve (he movie controller identifier and call 
MCUndo. Tlien we call calloc to allocate a 2-byte liuffcr, to liold 
the returned character and the null terminating hyte. 

The Ollier editing operatioas are quite similar, listing 4 
shows how we handle the mcCut command, and Listing 5 
shows how we handle the mcCopy command. Notice in lx>tli 
cases ihai we call PulMovieOnScrap to place the cut or copied 
movie segment onto the scrap. 


Listing 4: Cutting a movie selectira^ _ 

xcjio^Mcaii 

void XCHD_HCCut (char •argsU. iiit nargs. 

char “retstrlng. Bool ‘pass. Bool ‘error) 

I 

HovieController me == NULL; 

ComponoiitRoRUlt reiiult ” noErr: 

Movie oditmovio " NULL: 
char ‘reULt » NULL: 

‘pass “ false: 

‘error = false: 
if (nargfi »=* 1) { 

me ^ (HovieControXler)atol(argsfOl); 

tf {me I- NULL) [ 

edilroovic; = KGCuttmc): 

reauit “ (edltmovie t= NULL) ? result: InvaiidMovie: 


// pbcc the ait movie fiegtnent onto the scrap 
If (cdltmovie i- NUIX) I 

PutMovieOnScrop(ediitnovi0, OL) : 

DispoaeMovie tedltmovie); 
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retfiir = calloc(lt 2); 
if (retetr I" NULL) 

retstrfOl ^ (result “ noErr) 7 ’0*: ^1'; 
*retBtring “ retutr: 


Listing 5: Copying a movie selection 

XCMD.MCCopy 

void KCKC_MCCopy (char 'ergs[l» int nargs* 

char •*retstr$ngi Bool ‘pass, loo] ’error) 

I 

HovieController njc - NULL; 

ComponentResult result “ noErr; 

Movie aditniGvie NULL; 
char ’retatr “ NULL; 

‘pass * false: 

’error “ false; 
if (nargs =1) I 

jac = (MovieControlier)atol (args [0]): 

if Croc *“ NULL) I 

edltroovle ■ MCCopy(iflc) ; 

roflult “ (edltiiovle NULL) 7 resalt; invalidMovie; 

) 

» 

// place liic copied nnivic segment onto the scop 
if (editmovie J“ NULL) t 

PutHovicOnScrapCedltaovtc. OL): 
sposoHovlefedi movie): 

I 


retatr ^ oallocCK 2); 
if (retstr 1* NULL) 

retstrlOl - (result noEtr) ? '0^: 'L'; 
’rotstring “ retstr: 


ImplemeniutUm of XCMD^MCPaste and XCMD.MCClear is 
left as an easy exercise for the reader. (The complete ctKie for 
the QuickTime external is of course contained in the source 
code accompanying this article.) 

Selecting All or None of a Movie 

Our hdit menu contains further items. “Seleti Air and 
"Select None’', wliich are once again easy to implement. In 
earlier articles, we've seen liow to handle these items by calling 
MCDoAction with the mcActionSetSelectionDuralion selector. 
Listing 6 shows liow our Revolution external handles the 
selectAII enmmand, and Listing 7 shows how our Revolution 
external handles the selectNone command. 


Listing 6; Selecting ail of a movte 

XCMU_ScJfCtAll 

void XCHlLSeloctAM (char ’argufl, int nargs, 

chor *’retsirlng, Bew] 'pass, BqoI ‘error) 

1 

MovieController me ^ NULL: 

Movie iBV = NULL; 

Componentlteault result “ noErr: 

TimeRecord tr; 
char ’retstr ~ NULL: 

’pass " false; 

•error * false; 

If [uargs =1) I 

roc - (MovieGontroUer)atol (argsiOj); 


if (me !- NULL) t 
rov “ KCGetHovielmc); 
if (tBv) ( 

tr.value.hi = 0; 
tr. value, To “ 0; 

Ir.basc ” 0; 

tr.scale ^ GcLMovleTirocScale(mv): 
result - MCDoAction(me, 

mcActlouSetSelectioTiBegin, &t r): 


1 


tr.value.hi ^ 0; 

tr.value,lo " GetMovieOutation(mv); 

Lr.base ” 0; 

tr,scale - GetHovieTirooScale(mv): 
result = HCDoActloti(tnc, 

mcActionijetSelectioiiDuration, &tr): 


retstr - calloctl. 2); 
if (retstr 1= NUI+L) 

retstr LOj = (result *™ noErr) 7 *0"; M*; 
’retstring = retstr; 


Listing 7: Selecting none of a movie_ 

Xt;MD_SdmNonc 

void KCHD_5electNone (char ’argslJ, int nargs, 

char ’*retstrtng, Bool ’paeSt Bool ’error) 

E 

HovieControllGt «tc - NULL; 

Movie mv = NULL; 

Component Re suit result noEtr; 

TimeRecord tr; 
char ’retstr “ NULL: 

•pasfl = false; 

’error = false; 
if (nargs =1) [ 

flic = (MovleGontroller}aiol(argsto]): 

if (rac [= NULL) I 
iiv ” HCGetHovie(mo); 
if (mv) I 

Lr.value,hi ^ 0; 
tr.value, lo = 0: 
tr.base = 0; 

tr*scaJe ^ GetMovleTimeSraletiav); 
result MCDoAction (roc , 

rocActlonSetSeiectionDuratiou, &tr); 

I 

I 

I 


retstr = calioc(1, Z]; 
if (retstr t= NULL) 

retstr [01 = (result = noErr) 1 ^0': 'P; 
’retatrlng - retstr; 


Enabling and Disabling Edit Menu Items 

RunRevVeez needs to enable and disable the Edit menu 
items according to the edit .slate f)f tfie movie in a movie 
window. For instance, wlicn a movie is first ojiened and no edit 
operations liave yet occurred, die Undo item should be disabled. 
QuickTime provides the MCGetControllerlnfo himiion, which 
we've used in the past to adjust tlie stales of our edit menu 
itetiLs. We’U use it again here, as shown in Listing 8, 
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LLslin^ 8: Adjusting; the Edit menu_ 

?tCMD_MCEnnhkE^UMctiiiltoni 

void XC!fD_MCEnableKditWenulteBi (char 'argsM* int nargs, 
char "*retstring. Booi 'pass. Baol 'error) 

( 

HovieController me • HULLi 
CofEponentResult result * noKrr; 
long mclnfo ^ OL: 
aliort inden - 0; 
char 'retstr ” NULL.; 

'pass - false: 

•error falser 

retstr “ ma Hoc (2): // either "U' or" 1", plus the terminating null b^tc 

if (nargs ” 2} ( 

me ^ (Ffov IcGont roller)aloKargs [0]): 
index = tHtiari)atoi(args [1J): 

if Cmc !“ HULL) 

result “ MCGetControllcrInfo(ti]C, imcTnfo); 

I 


liisting 9; Adjusting the Edit menu 

mouscDown 

on mouseBown 

put first line of the openStackR into tbeTopStack 
put exists(player "HovIePlaycr* of stack theTopStack) \ 

Into gotplayer 

repeat Eot each iten Itemltidex In "1.3,4,5,6,8,9* 
if gotPlayer then 

if mcEnableEditHenuIteTiiCthe movioCont roller ID of \ 
player "MoviePlayer'* of stack theTopStack, \ 
itemlndex) Is ”1** then 
enable menuItGin Itenlridex of menu "Kdit" 
else 

disable tnenullem itemlndex gf menu "Edit" 
end if 
else 

disable meuultera Itemlndex of menu "Edit" 
end if 
end repeat 

end aouscDown 


switch (index) | 

case kUrtdoI LcmlndexT 

retstr [Ol ” racinfo k mcInfoUndoAvaiiable ? M*; *0'; 
break: 

case kCutltemlndex; 

retstrfOl - mclnfo k me InfoCut Avail able 7 M': *0*; 
break; 

case kCopyttemlndex: 

retstr[U] = mclnfo k mclnfoCopyAvailable ? M*: '0*: 
break; 


case kPastelteiaIndex: 

retfitTfOl * mclnfo 4 melnfoPasteAvailable ? M*: 'O'* 
break: 

case kCloarlLemlndex; 

retstr[0] ” racLnto 4 mcIpfoClearAvaiiahle 7 *1': 'O': 
break: 


case kSelectAllIteiilndex: 
case kSelectNorieltemlndex: 

retfitrtOl « mclnfo 4 mcTnfoKditingRuahlcd 7 M'; 'O': 
break; 

default: 

BebugStr("\pCOT AN INDEX WE DIDN'T EXPECTS): 
break; 


// tack on the tcfminatttiR null bjic 
retstrfl] " D: 

•rctstring = retstr; 


Notice that our code here kn^ks for iUfo parameters, which 
are the movie controller identifier and the index of the inenii 
item we want inforntation about. If, accortling to 
MCGetControllerInfo, the menu item with that index should Ix^ 
enabled, XCMD.MCEnableEditMenultem passes back the string 
{HherwLse it pas^ses back the string “0^ 

In RunRevVeez, the code that enables or disables the menu 
items is conlatned in the script attached to the menu item group 
(anti not to any p:itticular menu or item), 'fhat's because, w'hen 
die user clicks on the menu Irar, a mouseDown message is sent 
to the menu item group. We want to c'all mcEnableEditMenultem 
for each menu item index and adjust the menu item according 
to the value returned by h. 


We also need to adjust the slates of the items in the Fife 
menit and the Movie menu. Well postix>rie our consideration of 
the File menu to the next article. We am hanclle the Movie menu 
as sliown in lasting 10. 


lasting 10; Adjusting the Movie menu 

muiuiefkjwn 

It gotPlayer then 

euabls iiisnultem kSbowDarltcmIndex of menu '•Movie* 
enable munultetn kHideSpeakerltemlndex of menu "Movie" 
else 

disable menultem kShowBarltemlndex of menu "Movie" 
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disable meuul Lem kUldcSpeakerTtoniTtidex of menu ’'Movie" 
end if 


Here we use ;i few constants tfiat weVe defined in oiir mcssiige 
handler: 

constant kShowBarltemlndex = 1 
eonstajit kHideSpeakerltemlndex ” 2 


-Setting the Wintlt>w’ Status 

In tfie Ac|ua inierface, a window's close l>iition contains a 
dot if the inovie in the window has l>een modified since opened 
or last saved (compare Figure 3 wiili Figure 2). 


©e Sample Movie 



Hgure A nmiijhd movie window 

In earlier QuickTime Toolkit articles, we’ve seen that we can set 
the window mcxlificuion state by calling SetWindowModified. With 
Revolution, we need to aiU inu> our external to do tills, listing 
11 shows our definilion of llie XCMD^SetWindowModified fimetton. 


listing 111 Setting the window modification state 

XCMlKSclVtlndowMiKlifitd 

void XCMD_SetWiTidowModifled (char ’arg^tl. nargs* 
char ‘‘retstring. Bqol 'pass* Bool *error) 

WindowPtr wID - NULL: 

R£)ol<jan aTar€{ 

OSBrr rcaLilt noKrr; 
char ^relstr ** NULL: 

‘pass » false* 

'error * false: 
if (nargs ”2) I 

¥lD = (WindovFtrlatolCargs[OjJ* 
state " (Boolean)fltoi(argsfl]!: 

if (wIO !- NULL) 

result = SetWindo>rt1odified(wI0, state): 

) 

retfstr “ callac{l* 2 ): 

If (retstr !- NtJI.L) 

rcistrlO] “ (result ^ noErr) ? 'O': 

‘retstring “ retstr; 

I 


Tills is pretty much like all the external pimediireii weVe seen 
so fiir, except that the first panimeter here is of type WindowPtr. 
Our rail to windowSetModified looks like this: 

g^t windovScitModified(vindovID of stack thcTopStack* 1] 


A stack's window!D prof>erty contains the operating system ID of 
the window containing the stack; on IVUic OS, this ID Is a window 
pointer. (By the way, notice that we invoke the windowSetModified 
crimmand l>y passing it as an cxpiession to the get command- Hie 
"get expf’ command is a shortcut tor the expression: 

put ftpf into it 


We need to treat windowSetModified as a function, since Uiat's 
how we declared it. If we liad declared it as a command, we 
would omit the get.) 

We also need to keep track of a window s modification stale 
within our scripts in RunRevVeez (so, for instance, wc know 
whether to cnalile or disable some of the items in the File 
menu). We couid implement yet another funaiiin in our external 
that rails IsWindowModified. Or we can define a atslom property 
as^scKtiated with the movie window stack diat keeps track of this 
intxJification stale. Lets use a custom property. Open tlie movie 
window's property^ inspector palette anti select the "Custom 
Properties" panel in the pop-U|> menLi, Tlie original panel kx>ks 
like Figure A. 


Q Q Slack "MovieWindowL ID 1004 

@ 


Custom Properties 


ED 


@ 


Custom Properties: 




Sm; [ customKeys i ^ |^| 9 I ^ ] 


Property Con tents: 



Figure 4: The movie window's ammproperties 
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Click Uic icon Lo add a new property. Let's call the new 
property movieChanged. When a movie window is I'irst 
opened, this propeny should be set to 0, so set tlie property 
contents acc:Qrdingly. The property inspector palette now 

kx)ks like Figure 5. 


O Q $tack "MovieWtndowMD 10D4 



Set ■ cu&toniiKeys> | i ^ | 


Proper tv Cooreots; 

d 


put first line of the openStacks into theTopStack 
if exists(player ^KoviePIayor” of stack thcTopStack) then 
put the movleControllerlt) of plsyer "MoviePlayer’^ of \ 
stack theTopStack into me 
put false into changed 

switch pWhich 
case "Undo" 

if mcUn<io(itic) = "0" then put true into changed 
break 
case "Cut" 

if mcCutlmc] = ”0'^ then put true into changed 
break 

case "Copy" 
meCopy (me) 
break 

ease "Paste" 

If mcPasle(iisc) = "0" then put true into changed 

breEtk 

case "Clear" 

if mcClear(me) “ "0" then put true into changed 
break 

case "Select All" 
selectAll(roc) 
break 

case "Select None" 
selectNoneCmc) 
break 

end switch 
If changed then 

set the movicChanged of stack tbeTopStnek to true 
gel witidowSetModified \ 

(windowID of stack theTopStack, 1) 
slxeStackToMovie the short name of stack theTopStack 
end if 

end if 
end menuPick 


Wc also call Lht^ sizeStackToMovie mothtsd if the movie lias 
Ix^cn edited, since the size of the movie may liave changed. 


f igure 5: Ihe movie window's custom properties (Jhudl 

Once weVc done this, we can access the movieChanged 
property just like we access any of llie buill-in properties, for 
example like this: 

set the movl&Changod of stack tlisTopStack to true 

We'll see some examples of this in the next section, 

Moviii Eoitiwg 

We re now finished constriKling the movie editing jxations 
oi' our Revolution plug-in module. It’s veiy easy to put them to 
work. When the Liser selects an item in the Edit menu, the 
menuPick message handler of the Edit menu is called. Listifig 12 
shows (JUT complete menuPick hantller. Notice rliat we check to 
make sure that the value returned by the editing operations (for 
example, mcCut) is the string “0”, which indicates that the 
operation completed successfully. 


CoNc:i,iisiON 

In this article, we\e focused mainly on adding the ability 
to edit movies to our application KunRevVeex, We’ve seen 
how to c<instriict a plug-in that allows our Revolution scripts 
to invoke external code modules. This is liie primary avenue 
by whkh we can enhance the built-in behaviors and 
capabilities of Revolution, 

WeVe got a little bit more work to do to get RunRevVeez 
to operate precisely as desired. We still need to handle the 
“Save As" and Close menu items in the File menu, and we need 
to tie up a few remaining loose ends. We’ll tackle all that in the 
next article. 

Credits 

Thanks are due once again to Kevin Miller and Tuviah 
Snyder at Runtime Revolution Ltd. Tuviah was especially helpful 
with the plug-in. And a special thanks is again due to Gex>]T 
Canyon of Ins[:)ired Logic, LLC. 


Listing 12: Ilandling the Edit menu items 

tin t&eunPick pWhich 


nicniiPick 
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By Michael R. Harecy 


Laptop Cases 


So, you’ve got the laptop of the year, 
now what? 

List nt Mac Work! Hxpo San h'mnciscoj Steve Jobs 

prodainied 2003 ils ihc year of llie nolclxK)k for Apple 
Computer It was no idle boast, either, Apple has some of tlie 
best pc:)rtable computers on the market trxlay. Both the 12 and 
17 inch models were well received at MacWorid, and t!ie new^ 15 
inch Aluiiiiniiin l^owerBcjok G4 just released at Apple Expo Paris 
completes the line. Hut w'hal 6o you cany it in? They are some 
of ccx)lest, and most powerful laptops out there, but you still 
need to be able to get it, and its accessories fn>ni place to place. 

I decided to look at tlhs from a real world pros[Xx;tive. 1 
developed an iiiventory of items any user might need und/or cany 
wiili their P(>\verlk)ok on a regular basis. Tlie list was as follows: 

14“ iBook 

iB<K>k power adapter 
Spare iBook battery 
PDA 

Clell phone 
iPod 

Charging brick for iPc;d 

One each Ethernel, Firt*Wire, USB, phone, and HoiSync cihle 

Small optical mouse 

Two |>en5 

I'wo CD jewel cases 

Busine.ss cards 

One book (I happened to be reading Bicentennial Man l>y Isaac 
Asimov at the time of lliis review-) 

Three press kits (to simulate miscellaneous paperwork) 

With this pile of stufh 1 set out to test some ctirrent (offerings 
from various manufacturers to see if they could hajidle the load, 
and how well they could do it. 

Brfnthavkjv 

The offerings from Breruhaven are top nolcli. So much .so il tai 
they were tlie llrsi olTidal pRjvider of ceases to llie Apple Su;re. 
'Ibese are liigh quidity' products. Well built, sturdy, and loaded with 
nooks and crannies for stuffing things inre,). Our inventory was easily 
handled by the Professionitl 17 Shoulder Case I tested. In fact, 1 



dcjubled the load (except for computer), and this case was able to 
ainy it. The bag is very w^ell built. ‘Ibuglu ballistic nylon, with solid, 
easily ofx^nticd zip|x:rs throughout. There is a simp for sliding Lite 
handle of your wlicx4ed suitcise thiough. l1ie case lor liolding die 
laptop is deracliahle from the main case. There Ls an accordion file 
for jmperw'ork waihin the main compirntiieiYi, .scwenil sleeves for 
accessories, and haRlware, a [Yockel for a PDA, a key eliain liook. 
and even a sc'Cret small outside pocket just big enough to hold a 
plane ticket, and a passport. Ifs got a dual handle set up tor 
carrying, rs well as a decent shoLikler strap. I did not particularly 
care for the dual handle set up. I couldn't just grab and go. 1 had to 
Collett the two parts IxTore hauling the atse away. 'Ihe strap is 
attached to the case in such a way as to automatic^iliy cany it over 
ycxir hip, a much more ccanfortable position. The pad on the strap 
is only okay. It's soft, bill sticky feeling. Make sure it is resting on 
your shoulder exactly die way you want it lx?caiLse it will not slide 
at all. I think they nicmni it tliai way, but I found it to !x a detractor. 
Overall, this Ls a truly outstanding bag, ready to liandle nearly any 
need a user might have. It Ls available from the Apple Store for $149^ 

Kensington 

The.se guys make all sorts (.>f great peripherals for the Mac. 
The also hap[icn to have a really nice case called the Saddleliag 
Pro. TliLs bag was really a suqmse. Initially, 1 thought it would 
be okay, bur nothing special. I coukl not have been more wrong. 
The Saddlebag Pro is well designed, tough, durable, and can 
easily handle nearly anything you need it to. It has one main 
comparrnient wurh a padded divider for the laptop (which is able 
to handle up to the 17" PowerBcjok). The other side is spaciou.s 
and easily handled many of tlie items from the inventory- list, 
rhere is an c)uter area tlmi is covered by the flap with zippers on 
either sicie. This area has places for biLsiness c^rds, a key chain 
hook, and a [jocket for w-liaiever you want. The flap itself has 
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pt)cktn.s on either side. The main llap dial covers it all also has 
a zippered pocket on it. The carrying handle il attached here, ll 
is a single piece and very comtbrtahle to grip, even when the 
bag is loaded down. The shoulder strap on this case was 
oulsianding. Tlie ]>ad was very comfortable. Now, whal about all 
the cable clutter? It fits in a hidden drawer that slides out fif the 
lower side of the bag. 11 fit every random little piece of harrlware 
from the list easily. Two other additions tliat really aiughi my 
eye. One, the bag on expand. Unzip the flap around the back 
edge of the .Saddlebag Pro, and you give yourself even more 
room for those Limes when you have to lake an entire desk 
worth of paperwork home with you. Last, this thing converts to 
a backpack. A conipaitment just alcove die suitcase handle strap 
opens lo reveal sfjoulder si raps dial click lo rings, anti viola, 
backpack time. A nice addition for those times when you need 
to carry' different, although 1 wouldn't recointiiend using the l:>ag 
primarily in diis configuration. The backpac k .straps are none too 
comfortabie. The Saddleliag Pn^ can be I'ound many [ilaecs with 
an aveitige price of around S6(). 



Willow Design 

The Eastern Uirge Display Qiny^ C;ise is one of many fine 
bags from Willow Design, All of ilieir offering,s, much like 
eveiy^diing I tested, are made of high c|iialily materials, and 
excellent workmanshi]i. The Eastern case we tried was able to 
hold the inventory, but only just. It was a tight fit (some of their 
other larger cases would have had no problem). There are three 
outer pockets. One very thin one along the back of the case for 
holding no m{)re dian a magazine. The c:>ther two are on the 
froni side, one atop the oilier. The outer mo.st is just a zippered 
conij^artment. The larger one has fxjckets for anything you want 
to put in (the largest of which can hold a CD jew'el case). There 
is also a zippered mesh fxicker, 'Hie main compartment is where 
the uniqueness of this case shows. You acces.s il by ojKaiing up 
the top llap that unzips on three sides (and also has another 
zippered mesh pocket on the underside). It is one space that is 
split l)y a solid Ixiard. The laptop re.sT.s on it, and can be secured 
with a Velcrtj siia[i. Tlifi ufi die board, and space for all your 
accessories is exposed. It's actually a nice setup. You can work 
on the computer a,s U sits in the case ([iiiie ea.sily, accessing any 


papers from the pouches on the flap. The space underneath cun 
hold most all your accessories, as long as they aren't loo bulky 
and fit within the one of the three spaces the area is divided into. 
One Final note on this case, the shoulder strap and single piece 
handle are okay, tiut not the most comfortable of diose tested. 
Prices vary depending the model you choose, bin the Eastern 
Urge Display Carry Case is $90 direct from Willow Design, 

Crumpllr 

Grumpier automatically wins in the category of cool, or 
insane, looking bags (depending on your take on such tilings). 
Big, bright colors, and unique names are liallmaiks of the 
company, '['he test model they sent, for example, was called The 
Vt^ry Busy Man. This bag is all alxiui big spaces. Everything is 
covered by a large flap which both Velcros and clips closed. 
Four p<jckets make up the interior of the case. From front to 
i>ark: a zippered pocket that has several smaller pouches within 
it, that either zipper or Velcro closed, for small items. Next a 
large space For stuff, hooks, tomes, small cars. Tliiid pocket is a 
flap covered space for your laptop, It, as well as the entire bag, 
is veiy well padded. Tliis pouth c:an ea.sily hoki the largest 
PowerUook Apple ahs to offer, while also safely keeping tile 
smallest. 'The la,st jxicket is a smallei- zippered poucli probably 
best used for holding cables, and other accessories. Back to the 
outside of this monster, we find only a heavy duty shoulder 
strap. No handle, which I found to lx- a big minus, 'llie strap 
itself, however, is of good quality, w^ith a .sliding pad (the only 
one tested ihai has this). There is also a smaller strap from ihe 
Ixjrtom corner of the bag that hooks around hie slioulder .strap 
to help hold the case more securely to your txxiy wiien you are 
wearing it for extended periods of time. Caimpler bags are sold 
mostly Lhnjugh camcTa stores. To find a dealer near you, or an 
online dealer, check out their web site at www.crumplerusaxom. 

Does size really MAnm? 

Bigger isn't necessarily better, at least as far as laptop cases 
go. It may lx that you don't need lo carry the Rosetta Stones, 
and a Volkswagen around in yesur bag. If you only need to get 
your smaller laptoj^, and maybe u few oilier things at mo.5t from 
here to there, then one of these could be the hag for you. 

First up is McBain’s Baby from Cnimpler, Ifs one of their 
.snraDer laptop b^gs. it can hold a 12" iBook or Pow^erBook in its 
main comparitiient, and a few small I:>its in its zippered front 
pfvuch. The Hap Is held down by Velcro, The shoulder .stmp is 
adequate, and it even has a .small handle, unlike its big, and veiy 
busy, brother. 

Our next item up for review in die smaller is Ixrter caregoiy 
is die Courtney Slipcover from Willow Design. This is a very nice 
bag. Like the Cmmpler above, the C<Hiruiey can hold a 12" il^jok 
or PowerBcxik, It has two additional compartments, however. A 
small accordion file with a Velcro closing Hap is on the bat k tif 
the cuse. The front space lias pouches and mesh ziptiered 
compartments for accessories. There is even a detacluible key 
ring hidden along one side of the case. Very clever. 
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Brcnihavcn had iw<) £)fjerin^s I iried out in tijis calugor>\ 
I he first is the Professional 12 Shoiikier Case. A very fine bag, 
sjnall in size, hm with a lot of places to store sEuff, It can hantlie 
a 12” Apple laplcjp snugly, and has more places to store things 
tliaii you think it shoLild, considering its small form faaor with 
pouches for a t^DA, and otlier accessories, a key hook, and even 
a luggage handle strap, li also has handles an<i shoulder strap 
identiail to its bigger sihliiig. The second bag from Brenthaven 
was tlie Mobility One Messenger Bag. Much like the Professional 
12, this !>ag has more places for stuff dian you would think die 
laws of [diysics would allow. In fact, altliough this wasn't [)a[t of 
tile review criteria, this bag was able to htdd the test inventory I 
used on the larger Liags. It wiis pretty stuffed, biit it did it, and 
eveiylhing wa.s nicely accessible. It is also able U) hold the larger 
14” iBooks in its very well padded case. 



Flnal Analysis 

ChcKising a laptop case is a veiy personal ehoice. It lias to 
fit your needs exactly, and even Ixang off by just a little will nag 
at you. l-'or the smaller bags. 1 w^ent with the Willow' Design bag. 
It w'as small, hut still held a lot of stuff. As for the larger cases, 
the surprising whinner (or me was llie Kensington Saddlebag Pro. 
As 1 mentioned earlier, 1 thought this hag would be adequate, 
but nothing .special. 1 was totally surprised by how^ well this bag 
met my rcc[LUremenLs, It fit all my needs exactly. Let that l>e a 
warning, when you go looking for a case, discount nothing 
ahead of time, because you may just eliminate the perfect case 
without ever knowing it, 

I'hese are just my personal preferences, though. The 
Brenthaven bags are OLitstancling, They are very likely an 
outstanding choice for many users, Tfie Willow Design ca>ses 
would be great for those who tieed smaller sizes, and need to 
carry^ a bit less than our criteria set up, Then there is Cmmpler. 
Wacky, cool, Lmi<|ue, huge. Sound like your thing? 

Again, it's a personal choice, but choosing from any of the 
cases reviewed here will delinitely put a high quality, durable 
!)ag in your hands. juM make sure it fits your needs, and habits, 
and you will be very ha[>[)y with your choice. Good luck. 
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®MacPlay 


By Michael R. Harvey 

Offerings from MacPlay 


Waste time, have fun 


MacPlay are the folks who bang some of the greatest games 
you can lose hours of your life with to the Mac platform. 
Following is a round up of some of their current offerings. 


Live Forever? 



No. no one lives forever, not even in video games. 
Particularly not in this first person shooter. In Nt) One Lives 
Forever^ you take on the Role of Kate Archer, femine fatale, 
secret agent. She exists in the world of the super spy of the 
60's. This game lakes its cues from all the great spy Hicks 
of tiiat Lime. Tliis FPS is much like many otlters in the 
genre, except it's a lot more fun, Playing as a woman is 
different from most any other similar game, it\s got a good 
sLor>% and a Itetler soundtrack. In fact, you gel a bonus 
audio disc with some very groovy tunes on it. Well worth 
your time. Also note that by the time you read this, 
MacPlay w'ill have released pan two in this series, subtitled 
A Spy in H.A.R.M.'s Way, and promising to be a waMhy 
successor to this first episode. 


Not if this guy has anything to do with it 



Another FPS that takes on some of the more traditional aspecis 
of this kin<l of game is Solkler of Fortune TL Douhle Helix. Here 
you play, and kill, as mercenary John Mullins, sent out on various 
missions with the ultimate goal of stopping a terrorist 
oiganizaiion from releasing the deadly virus they have in hand. 
Even dioLigh it's much like iviany oilier .slKX>ters, it is a fun ride. 
The system requirements are hiiiiy modest, and the grapliics are 
quite good. If this kind of game b your thing. Soldier of FtMiune 
11 worlfi adding to your collection 

At your keyboard, everyone c:an hear you si:ream 



Aliens vs. Predator 2 is the stunning sequel to the original 
game that released on the Mac in 2001. This game takes you 
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to planet LV1201 to contintie the battle as either a killer 
Alien, the powerful Predator, or the well armed Colonial 
Marine, AvP2 is just as frightening and spellbinding as the 
first one was. Play it in a dark room with stirround sound, 
and yoifll swear you ean feel the breath of the bad guys on 
your neck. Truly a great game. And, if you never had a 
chance to play the first installment, you can buy it directly 
form MaePlay for five bucks. 


Roll piaying in a new way 



Many folks are addicted to these fantasy, and Dungeons and 
Dragons style games. The one tiling so many of them have in 
commtm is the time and place they are set in. Pur in the past, 
in the mystical land of somethtng-or-othen Not so vviili the 
Fallout series. The first came to the Mac for OS 9, and was a 
big hit, in pan because it was different from all the others in 
the genre. Fallout was set in the not too di.sram future, taking 
place in a post-apcx^lyplic Southern California. Fallout 2 was 
recently released for OS X, carrying forv^^ard the story. 
Beyond that, though, there is very little to differemtale pari 
two from part one. 'I'he graphics were not im[)roved lor the 
sequel, and the game ()!ay is identical. If you enjoy this genre, 
and are not concerned with top of the line graphics, then this 
game is for you. Also, you can add the original Fallout to your 
collectkm, as ii lia.s lieen re-released for OS X and offered by 
Maciday in their Value Series. 


hJbclMr 

MAGAZINE 

Get MacTech delivered to your door at a price FAR BELOW 
the newsstand price. And, it's RISK FREE! 
Subscribe Today! 
wvsnv.mactech.com 


Patriot Games 



Freedom Force is yet another genre of game that 11*18 been given 
a new, and refreshing twist. 1’his third person perspective game, 
that actually incorponites lx>ih 3D role playing and strategy into 
the game pby, takes you back to a decade filled with colortfil 
sujXT heroes, and fiendish villains. Set in Piiirioi City, you 
command the forces {>f gtK)cl set against an trther worldly evil 
Ix^nf on world dominaikm. I know, stxmds like any four l> 
movies youVe ever seen, hut this game is truly enjoyahie. 
Anolher title well worth your play time. 

Idle Time 

A[{ of tlie games weX e talked about up until now have fairly 
big costs in time and commiimeni aliarlu'd to ilietu. If you don’t 
have that kinil of desire to play, don’t liave die time, or jiLsi don’t 
want to bum tlie brain cells on liigl) speed games, a>nsider the 
Ibitowing. First up Is The Super GameHoiLse Solitaire Q^llectiotL 
1 wenty various .sfililaire c^rd games. A dream come laie for card 
pliyers. The games ItKjk gexjd, aitd play quickly on nearly any 
hardware. Next is Sntrwixill Hun, an tKicl little game in which you 
steer a penguin on a snow!xi II an Hind varitjus tracks. You are trying 
to get the little guy from one enti to the otlier as quicldy as possible, 
while also mnning over varitHis giXKiies. 'Iliis game really didn’t do 
it for me. It looks nice, hut just never captured my attentioiL Two 
other titles that fit in this cuiegory come on one CD. 1 Ugh Holler and 
Ik)wcT Chips are Ixith Las Vegas styled puzzle g;^tnies. Exircmely 
.simple to learn, and nearly :ls atldiciive. Tliink alxjut Itow badly 
letris sucked you in, and you've just alx>ui got it, In Power Chips, 
you click away at grtjups of the same chips (inu.si l>e three or 
more). For High Holler, you dick on twf> adkiceni Ixjxcs tcj switch 
them to get a combinatifin of three or intin.' identical lx)xes in a 
row'. Rtiil easy to play, atid renl exisy to lose time playing. 

£ni> Game 

These titles are just some of the many games available from 
.MacPlay. Nearly everyone will Ix" able Eo find something that 
will appeal to them from the array of titles on I land. Be sure to 
take a kxjk at their Value Series. MaePlay lias put up some 
popular, older titles, for a really great price. Enjoy! 

www.macplay.com 
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REVIEWS 


By Michael R. Harvey 

Speck Products FlipStand 


Their Sophomore Effort is an iPod 
accessoty homeruu 

Sjx^Lk has a nice collection of iPotl accessories 

available. Most are various protective, or r'anrying crises, for your 
iPod- The one I am l(M>kin)» at for this review i.s. I iliink, tlie lx?,si 
of iheir offerinj^s, not to mention the best cjf all ofTerings for the 
latest generation of iPrxJs. 

Speck really kn<x“ked one out of the park with their newest 
FlipSianil. This case is near |KTfeii. Solid, clear plastic's ]>rotect 
the iPod from scratch and impact damage. iTie hutlons are easily 
accessible, as is the sctoll wheeh for the most part (I’ll gel to that 
later). 7be top tkxir easily opens to allow' ytju to insert or 
remove ihe iPtxl, but still holds securely shut. Yr>u don t need to 
worry about it flying out of the case. There is a delacliahle l>ell 
dip. Anti* there is the flip cover that doubles as boili a pnjtecU)r 
for the .scroll wheel and a stand ann to allow the case to rest at 
a nice viewing angle on its ow^n. 

Okay, so that's the short tour of the case, and it's very cool. 
It is na, however, fht‘ ccK>lest fvari of this rig. The crxjlest hit is 
the dtx'k. Dtxk!? Why would you nc^^d a dock w^hen ihe new 
iPods etjme with one? Well liecause this ckx'k t'an hold ihe iPotf 
while it's siill in die case, lliis is a first. Until now^ you had it> 
remove your iPtxl from any a)vers in order to plug it into a doc’k. 
Even tJie latest iPtxJ dtK'ks only have space for the iPtxl itself. As 
the FlipStand adds afxntt 1/5 inch to the width, and i/i inch to 
the thickness of llie iPrxl, it just won't fit in the Apple dock while 
in tile case. The at.se that Speck provides w'ith the KlipSiand is 
specifically designed l(» Iiandle IPod and C'ise. It is we'ighted to 
keep it stable on your desk w'ith an iPtxl insertt^d, and has a slot 
to [jold Apide’s connecting aible to allow you to plug the iP<xl 
into your computer system when to put it in the d<)ck. This is 
exjictly the kind of thing .someone nevded to bring to the iPod 
accessory market. The main tiling that ethmp drove me nuts with 
tlie previoius version iPtxLs was having to yank it out of the ca.sc‘ 
to use any third parry dcxks (like the Traaspod or iPixIDock). 
Kudos to Speck for taking care of this glaring omission. 

Tiut w;is the liest part, so wliafs the wor?^? Rememtier my 
mention of gening to the scroll wheel atmssifiility Issue? That Ls the 
one thing 1 tion'i like alxxtt this case. Tlie flip cover of the aise tliat 
[irolecis tlie scToll wheel gets in the way of using it. Ihe volume of 
individual songs in my mnes collection tends to vary (despite the 



ecjualizer in iTuntrs), and 1 found it a [lain lo liave to flip the a>ver 
out of the way to turn tlie \'tjlume dtjwn when one of the blasters 
raiiglit me. My ean> w'ere usually ringing liy ilien. 1 found, how^ever, 
that the ttwer wiis uisily triiKJved from the case, witliout damaging 
it either, ^atli a little caie, ilic cover can Ix' pulled off tlie pasts that 
hold it to the main Ixxly. My prulilem wits Mjfved. Your mileage may 
vary, If you find die utility of the stand to lx- sometliing you can't 
live vvitliDut, leave tlie aise connected. 

Speck Products first PltpStand w^as only so-so. It felt Rimsy, 
was hard to open, and liid away the good looks of die iPexJ. This 
new FlipStand reminds me o{ Ck>titour Desigas case for the kist 
generation iPods, the iSee, Clear plastics that protect tlie iPi>d 
while siiTiultaneously shr>wing off its great style. The iJx'e was the 
l^est of the last generation t'uscs, and now the FlipStand has 
taken ifiat mantle and run with it. Gcxid looks, high durability, 
and the dcxrk make ihi.s accessory the one to gel for y<mr third 
generation iPrxl. And tiiai stuff aixml the flip cover, well it’s 
subjeclive, and easily worked around, lliis product is well worth 
die S29.95 price tag Speck Ls offering them at on their web site. 
Get one of the.se. You 11 be happy you did. 

www.speckproduas.com 
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KACI SHOWCASE 



Keep track of every second of your iime and bill 
for it with Time Track! Built in instructions make 
it easy to use. It is a simple way to manage yoor 
billable time for multiple projects and create a 
web page to show to your clients. Only $24,95 
per single user license per platform. Finallyl A 
versatile time tracking solution for Macintosh, 
Windows, and Palm! 


www.trinfinitysoflware.com 





By TLA Systems 


The Dock with more than one dimension. 


Create multiple docks of any size, assign hot keys and 
even put the Trash back on the Desktop, A flexible and 
feature-laden tool for power-users. Runs natively on Mac 
OS X and 9 in five languages. 

made the mkb IqOSXq ht msm for m?..M UViks 

’...DfagJhing can rightfully be called an Indhpensabk aid to working with your 
Mac..:^MacUserUK 


Download a copy now from www.draglhing.com. 



Trapcode - plug-ins for Adobe® After Effects® 


Trapcode Shine is a fast light effect plug-in. The effect looks 
very much like volumetric light, but is actually a 2D effect. 
There are special controls to make shimmering lights and 
numerous coloring modes. This is an effect that you see 
everyday on TV and in mony movie titles. Shine is available 
for Mac, Mac OSX and Windows. 


WWW. trapcode,com 



Eudora Internet Mail Server (EIMS) 
3.2 is the latest version of the most 
popular Internet mail server for the 
Macintosh, If you need to handle 
email for a dozen users, or 
thousands of users, EIMS is a 
reliable and easy to use solution. 


EIMS 3.2 Is avDilahb for US$400.00, there ere no limits on Ibe number of users 
tW can be odded, am! free email su|iport ts mcludod. 


Tor more informotioo, see 

http://www.eudora.co.nz/ 



GraphicConverter converts 
pictures to different 
formats. Also it contains 
many useful features for 
picture manipulation. 


See www.iemkesoft^com 

for more information. 
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Eggplant • Redstone Software, lnc..»,.....39 

ElMS * Endora Internet Mail Server........ . 79 

Eiisharpen * TechSmith Corporation --7 

Enterprise Software ‘MCE Software------^.27 

Fetcli • Fetch Softworks.^____—_ ^7 

Graphic Converter * Lemke Software GmbH.... ,.79 

Helpl.ogic ^ Electric Butt crily........ ■ ... ■■■■,.,■„ 18 

InstallerMakcr, Stuftli * Aladdin Systems, Inc............................11 

l.aw Offtees • Brad Sniderman-_- ■ i,-,. t....».43 

Long Dlstanee Phone Service * Utilittea41 vess,coni ..73 

MacDireccory * MacDi rcciory „ 75 

MacTcch Magazine Subscription * MacTedi Maga/iiic.............—-..71 

Macworld C.onft!rence & Expo * IDG World Expo Corporittion..».50-51 

Maximiziiig Your A4ae! • DevDepol..-«.......2S-29 

New Product • MYOB US, 

Notebook " Circus Ponies Software, I uc.^..^............ .^4 5 

piDog Utilities • piDog Software-.— ----.65 

POwerGlot • PowcrGlot Software......... — —-—.61 

PowerKcy Pm 9 ^ KidEOff! * Sophisticated Circuits, Inc__ 

Pre^o Vivace Services • Presto Vivace, Inc. ---—23 

PrimeBase • PrimeRaw (SNAP Innovation).47 
Qt • Tmlllcdt AS --------13 

Resnreerer • Mathemaejitthettes, Inc....—......15 

Runtime Revolution • Runtime Revolution I jmilcd™™~.«——JBC 

Stnain>og.eoni * Small Dog Electronics ....69 

Software Protection - WIBU SYS! EMS AG ____IBC 

Sophos Anti-Virus • Sophos, Inc._______—^-9 

Sound Smdio • Fell Tip Software-—--——---10 

Slock Icons • 'Die Iconfactory--——43 

TestTrack Pro • Seapine Software, Inc.---—--17 

ThinkFrec • ThinkEree Corporation —..——21 

1 mibnktn netOctopns • Netopia, Inc.......... .. ITC 

Translation & Localization * Lingo Systems...... ■.■.■■■■...■......3 5 

Useful Gifts & Gadgets * RadGaiL.^____——..75 

\^cntina * l^radigma Software,.,—— ...—31 

VUiiaLReport Tool Devdoper • WI—-——--41 

WhUticElower * James Sentman Software-—....56 

Wireless Networking « Trango Broadband Wireless____,, 35 


The Jrtclex on this page Is provicbd ns n service lo our readers. Hie pulilisher does not a-s^suine any liahiliiy for errors or omissions. 
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Be sure to order,a WIBU-KEY Protection Kit and find out why 
small software companies to Fortune 500 enterprises are 
switching to the WIBU-KEY Security, not Obscurity model for 
all of their software licensing needs, including: 




I 





■ Common API across all platforms and hardware 

■ Hardware-based code and data encryption 


Field-upgradable and reusable hardware 
The most cost-effective network licensing solution available 
The only system to employ RID/RED and AXAN security 
Engineered and manufactured to exacting IS09001 standards 


Test the 
WIBU-KEY 
ProtecUmn Kit 

sales@griftech.cofn 


Cali gQa-Stj(S-(£i78 


1 




The Key is in your Hands! 

UIBU 

SYSTEMS 


'i, 

' %■, 

WIBU-5Y% 
Seattle, Wfl 
Emaif: info4 


;W!S USA, Ine. 





vvll 


Protection Kits also available at: 

Bvlgiurfi wibuSicniMist.he, Denmerk tinibvM@flndhyi«-COfYC France jrrfci@Fief>l fr, Hutigruv jnloemrHiifLfiu Japan ififo@surKfrla co.jp, 

ilordan, Lebanon ftar^oftecybaria itei lbi Korea dhklmrtt@yPb4J.tjo.irr, Luhambourg wibuetmpakLbe, Netherlands wFbueimpaktbc, 

Portugal dubit@duhit.pr, Tbajland preechaedptf Co th, United Kinockun infoBcodPworkjcom, USAsalei@grifteth.coro 

























Softw/ar0 Development ^ ConsUltanoy 
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Missing you 
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t, , ^ Take the English language, add elegant XMU more SQL databases than you care to learn, . 

intrinsic video capture, Unicode,CGI scripting, sophisticated Reports, and build your solution faster than anyone else 
Jaguar, Panther, XP? Revolution lets you eat platforms for breakfast. And speaking of eating, our Cookbook of examples 








Revolution 2.0: the English like language designed around the way you think. 

Develop and deliver on Mac OS X, Windows and Linux ^ r, 

(not to mention 10 other platforms). ^ ' 


gets you up, running, and productive NOW.You can join the Revolution for as little as $99... 

Build with it, deliver with it love it - and still have time for vacations. 


And for a limited time, your MacTech special lets you get 100% of the Revolution for 15% off - 
go to speciaLrunrev.com NOW. Thousands of developers have already joined 
Don't let the Revolution in modern coding start without you... 


Software At The Speed Of Thought 

R 0 IITI M E 
-S^ RKOIVTIOR 




Runtime Revolution • 91 Hanover Street» Edinburgh EH2 1DJ • UK 
Phone +44 (0)131 718 4333 • Fax +44 (0)131 718 4334 • www.runrev.com • Email info@runrev.com 









